# Fitbit

Fitbit is a well-known brand that specializes in wearable technology designed to help users track various health and fitness metrics. Their product lineup includes a range of devices such as fitness trackers and smartwatches that can monitor heart rate, sleep patterns, step count, and more. 

## Data availability

Almost all epoch data from Fitbit is only provided when users actively record activities or during sleep periods. Daily data is always available.

**Special partnerships**: If you have a [special partnership with Fitbit](https://dev.fitbit.com/build/reference/web-api/intraday/), access to intraday data can be extended to include all intraday measurements. Thryve fully supports Fitbit's complete intraday data extension.

## Create your own oAuth-client for Fitbit

Follow these steps to create your dedicated Fitbit oAuth-client and integrate its credentials with our data source connection system seamlessly.

1. **Create a Fitbit account**

To create a Fitbit account, you first need to have a Google account. On the [Fitbit website](https://accounts.fitbit.com/signup), you can either log in with your existing Fitbit account (if you created one before Google acquired them) or choose the option to log in with Google. After the authorization, your Google account will be linked to a Fitbit account, which you can only log in to via your Google credentials. Use the same account to sign in to the [Fitbit developer dashboard](https://dev.fitbit.com/apps).

2. **Create an API application**

If you want to use the Fitbit API to pull data from your users, you'll need to register a new application under [Register an app](https://dev.fitbit.com/apps/new).

Enter the name of the application and a link to it, your website, privacy policy, and terms of service.

Choose 'server' application type and set the default access type to 'read only'

3. **Set Up the redirect URL**

Please enter the following redirect URL: `https://${appName}.und-gesund.de/dataSourcesSwitch.html` 

<figure><img src="https://597945514-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXHZczPNWZCe1I09YetDl%2Fuploads%2FKE56amGHpKgNwEZO8IWh%2Fimage.png?alt=media&#x26;token=d2cfab34-b0ac-4e35-b83f-58decc31f836" alt=""><figcaption><p>Illustrative Example: Fields Completed So Far</p></figcaption></figure>

4. **Add a subscriber**

Click on "Add a subscriber"

<figure><img src="https://597945514-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXHZczPNWZCe1I09YetDl%2Fuploads%2FQJR8dVhHgsSiv3Mwc73a%2Fimage.png?alt=media&#x26;token=a43d6ea5-3e5c-4f6c-ab17-4248fe6f985f" alt=""><figcaption><p>Select "Add a subscriber"</p></figcaption></figure>

* Set it to default
* Enter the following endpoint URL: `https://${appName}.und-gesund.de/dynDataSourcePing/Fitbit`&#x20;
* Ensure the Type is set to 'JSON body'.
* Set Subscriber ID field to `${appName}`&#x20;

<figure><img src="https://597945514-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXHZczPNWZCe1I09YetDl%2Fuploads%2FcMLsIZAke3T7n5SAxERf%2Fimage.png?alt=media&#x26;token=da12c2e7-9557-4def-b8cf-82b7639bffe3" alt=""><figcaption><p>Illustrative Example: Subscriber Setup</p></figcaption></figure>

5. **Share credentials with Thryve**&#x20;

After you have created your App, you will be provided with your:

* ClientID
* ClientSecret
* Subscriber verification code

Please encrypt these credentials using our [secret sharing service](https://secret.thryve.de/) and then [share](https://thryve.zendesk.com/hc/en-us/requests/new) the resulting link with our Customer Operations Team.

6. **Get confirmation from our Team**

Thryve will reach out to you to confirm that your credentials have been successfully integrated. Once they confirm, please click the “Verify Subscriber” button to enable ping messages.

<figure><img src="https://597945514-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXHZczPNWZCe1I09YetDl%2Fuploads%2FULIHleBfosKrgRDzsi8G%2Fimage.png?alt=media&#x26;token=fb0945eb-13f3-439e-84c1-cc3325a1a3e5" alt=""><figcaption><p>Click on "Verify" to enable Ping messages</p></figcaption></figure>

{% hint style="info" %}
Please confirm that the 'Subscriber has not been successfully verified' message is replaced with a verification timestamp (e.g. 2025-04-07T10:20:44.000Z)."
{% endhint %}

{% hint style="info" %}
Understanding the `${appName}` Variable

In this guide, you'll see the placeholder `${appName}`. Whenever you encounter it, replace it with your actual partner name, exactly as it's registered in our system.<br>

For example, if your app name is `yourcompany`, then:

`https://${appName}.und-gesund.de/dataSourcesSwitch.html`&#x20;

should become:

`https://yourcompany.und-gesund.de/dataSourcesSwitch.html`&#x20;

If you're unsure what your `${appName}` is, please refer your web authentication username, it usually follows the format `${appName}-api`. Otherwise, feel free to [contact us](https://thryve.zendesk.com/hc/en-us/requests/new) and we’ll confirm it for you.
{% endhint %}