2024.9.2
Home ▸ Integrations ▸

Withings

The Withings integrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more] consumes data from various health products produced by Withings.

Create a Withings developer account

You must have a developer account to distribute the data. Create a free developer account.

Create an application:

  1. Ensure you have selected Withings public cloud (instead of Withings US medical cloud)
  2. Create an application
  3. Application creation: Public API integration
  • Read and accept the terms if you’re happy by pressing Next
  1. Information:
  • Target environment: Development
  • Application name: [any name]
  • Application description: [any description]
  • Registered URLs: https://my.home-assistant.io/redirect/oauth
  • Change logo: Optional.

Once saved, the ClientID and Secret fields will be populated. You will need these in the next step.

I have manually disabled My Home Assistant

If you don’t have My Home Assistant on your installation, you can use <HOME_ASSISTANT_URL>/auth/external/callback as the redirect URI instead.

The <HOME_ASSISTANT_URL> must be the same as used during the configuration/ authentication process.

Withings will validate (with HTTP HEAD) these requirements each time you save your Withings developer account. When these checks fail, the Withings UI is not always clear about why.

  • Home Assistant (For create/update of Withings developer account):
    • Publicly accessible.
    • Running on a fully qualified domain name.
    • Running over HTTPS signed by a globally recognized Certificate Authority. Let’s Encrypt will work.

Note: You will only need one developer account; the same account and credentials are used for each Withings configuration.

Configuration

To add the Withings integration to your Home Assistant instance, use this My button:

Manual configuration steps

If the above My button doesn’t work, you can also perform the following steps manually:

  • Browse to your Home Assistant instance.

  • Go to Settings > Devices & Services.

  • In the bottom right corner, select the Add Integration button.

  • From the list, select Withings.

  • Follow the instructions on screen to complete the setup.

Data updates

The integrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more] automatically detects if you can use webhooks. This enables the integrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more] only to update when there is new data. The binary sensor for sleep will only work if the integrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more] can establish webhooks with Withings.

Available data

The integrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more] provides several entities, some of which are dynamically enabled if data is available.

For example, measurement sensors like weight only work when data has been registered in the last 14 days. So if you start using a new device, for example, to measure your temperature or you manually update a value in the app, the sensor automatically appears.

Sleep sensors are only created if the integrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more] can find sleep data for you within the last day.

Workout calendar and the workout and activity sensors show if the latest available data point is no older than 14 days.