Fitbit
The Fitbit sensor allows you to expose data from Fitbit to Home Assistant.
Prerequisites
You need to configure developer credentials to allow Home Assistant to access your Fitbit account.
- Your Fitbit account must be registered as a Developer account at the Fitbit Developer Portal, and have a verified email address.
- Visit Register an application.
- Enter an Application Name of your choosing, for example Home Assistant.
- Since we are creating a Personal registration, the details for Description, Application Website URL, Organization, etc. must be filled in. However, the contents do not matter and will only be shown to you on the authorization page later.
- Set OAuth 2.0 Application Type to Personal.
- Under Redirect URL, add
https://my.home-assistant.io/redirect/oauth. - You can leave Default Access Type as Read Only.
- Read the terms of service, check the box, then select Register.
- You will then be shown the page with your registered application, showing OAuth 2.0 Client ID and Client Secret. Make a note of these (for example, copy and paste them into a text editor), as you will need them shortly. You can always revisit this page through the Manage My Apps tab.
Configuration
To add the Fitbit integration to your Home Assistant instance, use this My button:
If the above My button doesn’t work, you can also perform the following steps manually:
-
Browse to your Home Assistant instance.
-
In the bottom right corner, select the Add Integration button.
-
From the list, select Fitbit.
-
Follow the instructions on screen to complete the setup.
The integration setup will next give you instructions to enter the Application Credentials (OAuth Client ID and Client Secret) and authorize Home Assistant to access your Fitbit account
- Continue through the steps of selecting the account you want to authorize.
- You will be asked to grant access to specific data in your Fitbit account.
- For Home Assistant to understand your account, select profile.
- All other data is optional. Home Assistant will create entities based on the information you select. For example, if you allow access to Activity and exercise, then Home Assistant will create activity-related sensors such as
sensor.step. - The page will now display Link account to Home Assistant?, note Your instance URL. If this is not correct, refer to My Home Assistant. If everything looks good, select Link Account.
- You may close the window, and return back to Home Assistant where you should see a Success! message from Home Assistant.
Additional information
Please be aware that Fitbit has very low rate limits, 150 per user per hour. The clock resets at the top of the hour (meaning it is not a rolling 60 minutes). There is no way around the limits. Due to the rate limits, the sensor only updates every 30 minutes. You can manually trigger an update by restarting Home Assistant. Keep in mind that 1 request is used for every sensor.
The unit system that the sensor will use is based on the country you set in your Fitbit profile.