> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gymlive.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Fitbit Integration

> Connect your Fitbit devices with GymLive to track your daily activity and wellness

# Fitbit Integration

Fitbit provides comprehensive health and fitness tracking across a wide range of affordable devices. Connect your Fitbit account to GymLive to share your activity, sleep, and health data with your coach.

<Info>
  Fitbit integration uses OAuth authentication - you'll sign in with your Fitbit account to authorize GymLive access.
</Info>

## What Data Can Be Synced?

Fitbit tracks extensive health and wellness metrics:

* **Daily Activity**: Steps, distance, floors climbed, calories burned
* **Active Minutes**: Zone minutes (fat burn, cardio, peak)
* **Heart Rate**: Continuous tracking, resting HR, HR zones
* **Sleep**: Duration, stages (light, deep, REM), sleep score
* **Workouts**: Auto-detected and logged exercises with GPS routes
* **Body Metrics**: Weight, BMI, body fat % (with Aria scales)
* **Women's Health**: Menstrual cycle tracking
* **Stress Management**: EDA responses (Sense/Charge 5)
* **Readiness Score**: Daily readiness based on activity, HRV, and sleep

## Setup Instructions

<Steps>
  <Step title="Prepare Your Fitbit Account">
    Ensure your Fitbit is syncing properly:

    1. Open the **Fitbit** app on your phone
    2. Check that your device shows as connected
    3. Verify today's stats are current
    4. Ensure your profile information is complete

    <Note>
      Your Fitbit should sync automatically when near your phone with Bluetooth on.
    </Note>
  </Step>

  <Step title="Connect Fitbit to GymLive">
    In the GymLive app:

    1. Navigate to **Settings** > **Integrations**
    2. Select **Fitbit**
    3. Tap **Sign in with Fitbit**
    4. You'll be redirected to Fitbit's secure login
  </Step>

  <Step title="Authorize GymLive">
    On Fitbit's authorization page:

    1. Enter your Fitbit email and password
    2. Review the data permissions requested
    3. Select the data types you want to share
    4. Click **Allow** to grant access
    5. You'll return to GymLive automatically

    <Warning>
      Make sure you're using the account linked to your Fitbit device, not a different email.
    </Warning>
  </Step>

  <Step title="Verify Connection">
    Back in GymLive:

    1. Fitbit should show as "Connected"
    2. Your recent data will begin syncing
    3. Historical data (up to 30 days) syncs gradually
    4. New data syncs automatically throughout the day
  </Step>
</Steps>

## Verifying Your Fitbit User ID

If data isn't syncing, verify you're using the correct account:

1. Open **Fitbit app**
2. Tap your **profile picture** (top left)
3. Tap your **Fitbit display name**
4. Select **Personal**
5. Scroll to bottom to see your **Fitbit User ID**
6. Confirm this matches the account connected to GymLive

## Understanding Fitbit Metrics

### Active Zone Minutes

Personalized heart rate zones:

<CardGroup cols={3}>
  <Card title="Fat Burn Zone" icon="fire">
    50-69% max HR - Builds endurance
  </Card>

  <Card title="Cardio Zone" icon="heart">
    70-84% max HR - Improves cardiovascular fitness
  </Card>

  <Card title="Peak Zone" icon="bolt">
    85%+ max HR - Increases performance
  </Card>
</CardGroup>

### Sleep Score

0-100 score based on:

* **Duration**: Time asleep vs. time in bed
* **Quality**: Deep and REM sleep percentages
* **Restoration**: Resting heart rate and restlessness

### Daily Readiness (Premium)

Available on Sense 2, Charge 5/6, Inspire 3:

* Based on HRV, recent activity, and sleep
* Suggests workout intensity for the day
* Requires Fitbit Premium subscription

## Device-Specific Features

<Tabs>
  <Tab title="Sense Series">
    Advanced health sensors:

    * EDA for stress tracking
    * Skin temperature variations
    * ECG app (select regions)
    * SpO2 tracking
    * Built-in GPS
  </Tab>

  <Tab title="Versa Series">
    Smartwatch features:

    * On-device workouts
    * Music storage
    * Always-on display
    * Built-in GPS (Versa 3+)
    * Voice assistants
  </Tab>

  <Tab title="Charge Series">
    Fitness-focused tracker:

    * Slim profile for 24/7 wear
    * Built-in GPS (Charge 4+)
    * Active Zone Minutes
    * Stress management (Charge 5+)
    * 7-day battery life
  </Tab>

  <Tab title="Inspire Series">
    Essential tracking:

    * Basic activity metrics
    * Sleep tracking
    * Connected GPS via phone
    * 10-day battery life
    * Water resistant
  </Tab>
</Tabs>

## Syncing Best Practices

### Automatic Syncing

Fitbit syncs when:

* Within 30 feet of phone with Bluetooth on
* Every 15 minutes if actively tracking
* When you open the Fitbit app
* After completing a workout

### Manual Sync

Force a sync by:

1. Opening Fitbit app
2. Pull down from top of dashboard
3. Wait for sync to complete
4. Check GymLive after 2-3 minutes

## Troubleshooting

<AccordionGroup>
  <Accordion title="Data not appearing in GymLive">
    1. **Check Fitbit app first**:
       * Open Fitbit app
       * Verify today's data is current
       * Force sync by pulling down
    2. **Verify connection**:
       * GymLive Settings > Integrations
       * Fitbit should show "Connected"
       * Try disconnecting and reconnecting
    3. **Check permissions**:
       * May need to reauthorize after Fitbit updates
       * Ensure all requested data types are allowed
  </Accordion>

  <Accordion title="Wrong Fitbit account connected">
    Common issue with multiple accounts:

    1. Disconnect Fitbit in GymLive
    2. Log out of Fitbit app
    3. Log into correct Fitbit account
    4. Reconnect to GymLive
    5. Verify User ID matches (see section above)
  </Accordion>

  <Accordion title="Historical data missing">
    Fitbit API limitations:

    * Only 30 days of historical data on initial sync
    * Some detailed data (intraday) requires special permissions
    * Deleted Fitbit data won't sync to GymLive

    Going forward, all new data syncs automatically
  </Accordion>

  <Accordion title="Sync delays">
    Normal sync timeline:

    * Device to Fitbit app: 1-15 minutes
    * Fitbit app to cloud: Immediate when app opens
    * Fitbit cloud to GymLive: 5-15 minutes

    Premium features may sync faster
  </Accordion>
</AccordionGroup>

## Fitbit Premium Features

If you have Fitbit Premium, additional data syncs:

* **Readiness Score**: Daily training recommendations
* **Sleep Profile**: Monthly sleep animal and insights
* **Wellness Report**: Comprehensive health trends
* **Advanced Sleep Tools**: Sleep restoration metrics
* **Guided Programs**: Workout and mindfulness content

<Note>
  Premium features sync to GymLive but require active Fitbit Premium subscription.
</Note>

## Battery Optimization

To ensure consistent syncing:

1. **Phone Settings**:
   * Allow Fitbit app to run in background
   * Disable battery optimization for Fitbit
   * Keep Bluetooth always on

2. **Fitbit Device**:
   * Charge regularly (varies by device)
   * Enable All-Day Sync in device settings
   * Turn off features you don't use to extend battery

## Privacy & Security

* Fitbit uses OAuth 2.0 for secure authentication
* GymLive never sees your Fitbit password
* You control which data types are shared
* Revoke access anytime in Fitbit account settings
* Data is encrypted during transmission
* Compliant with health data regulations

## Tips for Accurate Data

<CardGroup cols={2}>
  <Card title="Wear Correctly" icon="hand">
    One finger width above wrist bone, snug but comfortable
  </Card>

  <Card title="Keep Updated" icon="download">
    Update Fitbit app and device firmware regularly
  </Card>

  <Card title="Log Details" icon="pencil">
    Add context to workouts (type, intensity, notes)
  </Card>

  <Card title="Consistent Wear" icon="clock">
    Wear device 24/7 except when charging
  </Card>
</CardGroup>

## Social Features

Fitbit's social features that benefit coaching:

* **Challenges**: Join coach-created step challenges
* **Friends**: Connect with training partners
* **Community**: Share achievements and milestones
* **Badges**: Celebrate reaching goals

Your coach can see your challenge participation and achievements through GymLive.

## Related Resources

* [Fitbit Help Center](https://help.fitbit.com/)
* [Device Comparison Guide](https://www.fitbit.com/global/us/products/compare)
* [GymLive Troubleshooting Guide](/integrations/troubleshooting)