Can someone explain the fitbit integration?

HTX · February 27, 2023, 9:10am

Ok I figured it out also. The main problem is that the documentation on the Fitbit integration page is terrible.

You have to be connecting to HA with https. (not mentioned)
You have to have the instance named correctly under Settings → network → local network with the https url (not mentioned)
You have to edit the fitbit.conf file, which is easy but there’s no mention that the file already exists. I spent a lot of time trying to find an example of that file when all I really had to do was open it and enter the info. It should be mentioned that the file was created by the fitbit integration at the correct location and that it is already set up except for the values you must enter.
It errors because when you click the button on the fitbit site to allow the integration, it redirects to your HA instance, which prompts you to download the callback. Obviously the callback isn’t configured correctly. There is no indication on the fitbit site or anywhere else that it was successful.
There is no mention that you have to restart at least twice.

Once you’re done, the various data you set up in the main config file are listed as entities. You can then add them to your dashboard, etc.

john2014 · February 27, 2023, 9:26am

wow, nice write up! And yes I do remember that fitbit.conf file to also be a major issue for me. I hope whoever manages Fitbit - Home Assistant (home-assistant.io) will see your post and update that page.

mankyd · March 22, 2023, 1:40am

What does your fitbit.conf look like? Mine wasn’t created or setup, and I have no idea how to format the two values.

john2014 · March 22, 2023, 6:04am

My fitbit.conf looks like this

{
  "access_token": "[access token]",
  "refresh_token": "[refresh token]",
  "client_id": "[client id]",
  "client_secret": "[client secret]",
  "last_saved_at": 1679464765
}

john2014 · March 22, 2023, 6:06am

@HTX I noticed that the documentation is just a wiki so we could modify it ourselves. But I cant really reproduce the steps fully anymore to write a good explanation there. Do you still have the full overview?

gaborbernat · March 22, 2023, 6:07am

Where do you get the:

{
  "client_id": "CLIENT_ID_HERE",
  "client_secret": "CLIENT_SECRET_HERE"
}

from?

john2014 · March 22, 2023, 6:09am

you get the client id/secret from
https://dev.fitbit.com/apps

benoit505 · March 29, 2023, 12:55pm

Might be a dumb question but where to get the other parts?

{
“access_token”: “[access token]”,
“refresh_token”: “[refresh token]”,

soopercheeze · June 21, 2023, 2:55pm

I just went through this. After you complete the configuration and authorize the app access, the tokens are populated in fitbit.conf automatically by the integration.

Ron_Bln · July 17, 2023, 12:00pm

Hi there, I´m also trying to get the fitbit integration working and it seems to be impossible following the “official” documentation

This is the status quo:

I´m using cloudflare to connect to my HA which has a SSL connection.
I added the configuration to configuration.yaml as documented
I created an App within the Fitbit developer account
I entered the Client ID + client secret in the fitbit.conf
A fitbit entity (configurator.fitbit) is showing up in my system

Now, when trying to authorize the integration, I come to a page telling me that

“Developer information: invalid_request - Invalid redirect_uri parameter value”

Did anybody had a similar problem?

dlemmink · July 20, 2023, 5:48pm

Same here. Running SSL with a wildcard SLL certificate. Set up the App within the Fitbit developer account, and entered the Client ID & secret. I get the same error:

“Developer information: invalid_request - Invalid redirect_uri parameter value”

local and internet URL point to FQN with https:// prefix

rebooted multiple times
also tried adding a trailing"/" to the redirect url in the developer account per other threads.

config yaml file as follows:

sensor:

platform: fitbit
clock_format: 12H
unit_system: en_US
monitored_resources:
- “body/weight”

d2blake · August 3, 2023, 2:43pm

Did you figure this out? I’m at the same point.

Ron_Bln · August 3, 2023, 3:02pm

Nope - Didn´t find a way to get it going

d2blake · August 4, 2023, 7:54pm

OK I got it working…

Update configuration.yaml with (more sensors can be added than the two listed):

sensor:
  - platform: fitbit
    clock_format: 24H
    monitored_resources:
      - "body/weight"
      - "activities/activityCalories"

I had an existing fitbit.config folder that I deleted, then restarted HA. This recreates the fitbit.config.
Go to Entities and you should find one called Fitbit. Click on it and then go to Info. There should be instructions here to follow… Including, go to Login, make sure Application Type is Personal. Set Callback (Redirect URL) is your https://[your_HA].ui.nabu.casa/api/fitbit/callback
Then go update fitbit.config file with Client ID and Secret. Others have mentioned Access and Refresh Tokens but these get automatically added later.

Screenshot 2023-08-04 154247490×595 79.1 KB
After Clicking I HAVE SAVED CLIENT ID AND SECRET, a new Fitbit entity should load. Go into it, then info again and there should be a link to follow to Authorize Fitbit. Following that link, selecting all and clicking ALLOW cause a file to download but I just went back to HA and clicked I HAVE AUTHORIZED FITBIT.
Restart HA and entities should load. I had 1 entity load without restarting, then after restart they were all there.

Hopefully this works!

Ron_Bln · August 17, 2023, 5:27pm

Thanks much for sharing @d2blake! Unfortunately, I´m not using Nabu Case so I´m afraid this won´t work for me

Kuechenfenster · August 18, 2023, 12:50am

in case you hold a domain you can use, you could then also run it via Cloudflare.
if not you can buy yourself a cheap domain *e.g. godaddy or directly at cloudflare and set a direct, encrypted https access to your home assistant.

Ron_Bln · August 18, 2023, 7:36am

Thanks @Kuechenfenster for the reply. In fact I´m already using Cloudflare. I tried to set up the fitbit integration again but now, not even the fitbit entity is showing up in my HA anymore

So thats the configuration for my configuration.yaml:

# Fitbit
sensor:
  - platform: fitbit
    clock_format: 24H
    monitored_resources:
      - "activities/calories"
      - "activities/steps"
      - "activities/distance"

This is in the fitbit.conf:

{
  "client_id": "23XXXX",
  "client_secret": "db4bXXXXX"
}

And thats how I configured the fitbit App:

Any one an idea where might be the problem?

Kuechenfenster · August 18, 2023, 9:14am

as a smartass as I’m I noticed my fitbit integration is currently offline as well… had no time to look into it yet. maybe it could be as fitbit cloud is now transfered to google directly… I’m unsure …

DeFlanko · September 13, 2023, 3:53pm

Can anyone confirm if this integration is broken or not once after your Fitbit account migrates to Google? I originally set this up before the migration and it was working, after my account was migrates to Google it stopped working. I’ve made a new app in Dev Fitbit, still no joy.

Would this now be accessable via the Google integration?

Mindraid · October 29, 2024, 6:59pm

Well it works, I get data from Fitbit.
I’m not sure what I will use the data for, I was just curious to test the fitbit integration.