# Fitbit
Let users log in with their Fitbit accounts, fetch their workout data, and update their subscription status.
{% hint style="info" %}
This is the short-form, technical reference for the Fitbit plugin. For a more in-depth explanation of the plugin and how it works, see our User Manual article below:
Article: [The Fitbit plugin](https://manual.bubble.io/~/changes/1188/help-guides/data/user-accounts/authentication-plugins/fitbit-plugin)
{% endhint %}
## **Signup/login with a social network**
This workflow action allows you to integrate the Fitbit authentication event when registering a new user, or logging in an existing user.
### **OAuth provider**
Allows the Fitbit editor to verify the correct social platform to login/signup the user.
## **Invite Fitbit friend**
Send a friend request to another Fitbit user.
### InvitedUserEmail
The email address of a user’s Fitbit account that the current user would like to send an invite to.
## **Accept Fitbit friend invitation**
Accept a friend request from another Fitbit user.
### **FromUserID**
When choosing to accept a friend request, this is the ID of a Fitbit user's account that will be added to the current user’s friend list.
## **Add Fitbit subscription**
Start a Fitbit subscription.
### **SubscriptionID**
The unique characters to reference a user's Fitbit subscription.
## **Delete Fitbit subscription**
Remove a Fitbit subscription.
### **CollectionPath**
Collection of data to retrieve notifications. If the collection is not provided, the list will include all subscriptions for the user.
## **Current user’s Fitbit profile**
When adding dynamic data, this expression allows you to fetch and display the profile information from a user’s connected Fitbit account.
### **ID**
The unique ID of a user’s Fitbit account.
### **Avatar**
The profile photo from a user’s Fitbit account.
### **FullName**
The full name from a user’s connected Fitbit account.
### **Nickname**
The alternative name added to a user’s connected Fitbit account.
### **AboutMe**
The profile description from a user’s connected Fitbit account.
### **Age**
The age of a user saved within their Fitbit account.
### **Height**
The height of a user saved within their Fitbit account.
### **Weight**
The weight of a user saved within their Fitbit account.
### **DateOfBirth**
The birth date of a user saved within their Fitbit account.
### **MemberSince**
The date that a user initially created their Fitbit account.
## **Current user’s Fitbit daily activities**
Allows you to fetch the user’s workout data from a specific date.
### Activities
A list of all the recorded activities from a user’s account.
### Goals\_caloriesOut
Calorie burn goal represents either dynamic daily target from the premium trainer plan or manual calorie burn goal.
### Goals\_distance
The target distance traveled within a user’s Fitbit account for a specified date.
### Goals\_floors
The target amount of floors climbed within a user’s Fitbit account for a specified date.
### Goals\_steps
The target number of steps within a user’s Fitbit account for a specified date.
## **Current user’s Fitbit food log**
Allows you to fetch the user’s log food intake data from a specified date.
### Foods
The recorded foods a user consumed on a specified date.
### Summary\_calories
A summary of the total calories consumed by a user on a specified date.
### Summary\_carbs
A summary of the total carbs consumed by a user on a specified date.
### Summary\_fat
A summary of the total fat consumed by a user on a specified date.
### Summary\_fiber
A summary of the total fiber consumed by a user on a specified date.
### Summary\_protein
A summary of the total protein consumed by a user on a specified date.
### Summary\_sodium
A summary of the total sodium consumed by a user on a specified date.
### Summary\_water
A summary of the total water consumed by a user on a specified date.
## Current user’s Fitbit sleep log
Allows you to fetch the user’s logged sleep data from a specific date.
### TotalMinutesAsleep
A summary of the total minutes a user slept on a specified date.
### TotalSleepRecords
The total number of sleep records stored within a user’s Fitbit account.
### TotalTimeInBed
A summary of the total minutes a user spent in bed - both awake and asleep.
## Current user’s Fitbit heart rate log
Allows you to fetch the user’s heart rate data logged from a specific date.
### CaloriesOut
The total number of calories a user burnt on a specified date
### Max
The max heart rate recorded on a specified date.
### Min
The minimum heart rate recorded on a specified date.
### Minutes
The duration of each session where a heart rate was elevated.
### Name
The name given to a workout session where the user’s heart rate was elevated.
## Current user’s Fitbit lifetime activities
The total activity statistics from a user’s Fitbit account. This is an overview of all their historical key data points, as well as achievement values.
### Lifetime\_total\_caloriesOut
The total number of calories a user has burnt since the creation of their account.
### Lifetime\_total\_distance
The total distance traveled by a user since the creation of their account.
### Lifetime\_total\_floors
The total number of floors a user has climbed since the creation of their account.
### Lifetime\_total\_activeScore
The average active score given to a user’s account based on their lifetime activity.
## Current user’s Fitbit device
The Fitbit device model linked to the user’s account.
### ID
The device ID on a user’s linked Fitbit device.
### Battery
The current battery level of a user’s linked Fitbit device.
### DeviceVersion
The device model of a user’s linked Fitbit device.
### Type
The type of device linked to a user’s account e.g. fitness tracker, scales.
### LastSyncTime
The last recorded time that a user’s device was synced to their account.
## Current user’s Fitbit friends
A list of all the friends connected to a user’s Fitbit account.
### ID
The unique ID of a friend’s Fitbit account.
### Avatar
The profile photo of a friend’s Fitbit account.
### FullName
The full name listed on a friend’s Fitbit account.
### Nickname
The alternative name added to a friend’s Fitbit account.
### AboutMe
The profile description from a friend’s Fitbit account.
### Age
The age saved on a friend’s Fitbit account.
### Height
The height saved on a friend’s Fitbit account.
### Weight
The weight saved on a friend’s Fitbit account.
### DateOfBirth
The date of birth saved on a friend’s Fitbit account.
### MemberSince
The date that a user’s friend registered initially created their Fitbit account.
## Current user’s Fitbit friends invitations
A list of the current friend requests to a user’s Fitbit account.
### DateTime
The date and time that a friend request was sent.
### User
The user who has sent the current user a Fitbit friend invite.
## Current user’s Fitbit subscription
Allows you to fetch the user’s heart rate data logged from a specific date.
### CollectionType
The type of Fitbit subscription e.g. activities, body, sleep, etc
### OwnerID
The ID of the user who owns the subscription.
### OwnerType
The type of entity who owns the current subscription e.g. user
### SubscriberID
The ID of the subscriber that will receive the subscription notifications.
### SubscriptionID
This is the unique ID of the subscription created by the API client application.
## **Setup**
### Configuring your API
Once you’ve installed the Fitbit plugin, you’ll need to first create a [developer account](https://dev.fitbit.com/getting-started/) to secure access to an OAuth key.
After registering a developer account, you’ll then need to register a new app within the Fitbit [developer portal](https://dev.fitbit.com/apps).
Once the details of your app have been added, you’ll be provided with a client ID and secret key for your OAuth 2.0 integration.
Now, you’ll need to copy both the client ID and client secret keys into their relevant fields within your plugin settings.
Note: It’s also possible to enable a generic redirect URL within the Bubble plugin settings itself.
### Logging a user in through Fitbit
After configuring your OAuth credentials, you can now use the ‘signup/login with social network’ step within a workflow. From the event dropdown menu, you’ll see an option to select the Fitbit OAuth provider. This event can be added to an element like a login button.
After a user clicks this button, they’ll be redirected to a Fitbit portal where they can verify their account, then be redirected back to the destination URL of your application.
Now, you can choose to display information from a user's Fitbit account by using the ‘current user’s Fitbit’ operator.
### Accepting a friend invitation
To display a list of a user’s Fitbit friend invitations, start by adding a repeating group element to the page. The type of content for this repeating group will need to be configured as ‘Fitbit Friend Invitation’.
Now, you’ll also need to update the data source to display the ‘current user’s Fitbit friends invitations’.
Now, within the repeating group cell, you can display information from a user’s Fitbit profile who has sent a friend invitation.
From here, when the accept button is clicked, you can create a workflow and choose from the ‘accept Fitbit friend invitation’ event.
When configuring this workflow event, you’ll need to set the FromUserID to be the ‘current cell’s Fitbit friend’s invitation’s User ID’.
### Inviting a Fitbit friend
In order to allow the current user to send a Fitbit friend invitation, select the ‘invite Fitbit friend’ workflow event.
Within this workflow event, you’ll need to configure an email value associated with a user’s Fitbit account. This can be attained through an input form.
### Adding a Fitbit subscription
When adding a new Fitbit subscription, select the ‘add a Fitbit subscription’ event within your workflow editor.
When adding a new subscriber, you’ll need to associate a SubscriptionID to the current user. This unique ID will be shared with Fitbit. As Fitbit states within their [API docs](https://dev.fitbit.com/build/reference/web-api/subscriptions/), this ID has a character limit of 50 characters.
Within a Bubble input, it’s possible to use the formula operator to generate a random character string.
Now, when configuring your subscription workflow event, it’s possible to use the value of this input field as the SubscriptionID.
We’d also recommend storing this SubscriptionID as a field under your user data type. This will allow you to reference this unique ID if the user chooses to delete their subscription at a later date.
### Deleting a Fitbit subscription
When deleting a user’s Fitbit subscription, select from the ‘delete a Fitbit subscription’ workflow event.
When configuring this workflow step, you’ll need to provide the subscription type that the user will be canceling.
Note: If the CollectionPath is not provided, subscriptions will be deleted from all collections.
Next, you’ll need to verify what subscription ID you’ll be deleting. If you’ve stored the current user’s subscription ID within your database, you can reference this here.
## **FAQ**
(Have a suggested FAQ to help other Bubblers? Please visit our [Support center](https://bubble.io/support) to get in touch with a member of our Support team!)