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.

Prerequisites

  • Withings account
  • Withings app installed
  • Withings device setup in the app
  • Withings developer account to get a ClientID and Secret to connect to be able to get the data from the Withings cloud API

Creating a Withings developer account

You must have a developer account to distribute the data.

Note

You only need one developer account. The same account and credentials are used for each Withings configuration.

  1. Create a free developer account.
  2. Make sure to select Withings public cloud (and not Withings US medical cloud or similar).
  3. Select Create an application.
  4. Under Application creation, select Public API integration.
    • Read and accept the terms and select Next.
  5. Under Information:
    • Target environment: Development
    • Application name: [any name]
    • Application description: [any description]
    • Registered URLs: https://my.home-assistant.io/redirect/oauth
      • Do not test this URL. It won’t work at this stage. It will be setup once you install the integration in Home Assistant.
    • Change logo: Optional
  6. Save your changes.
    • Once saved, the ClientID and Secret fields will be populated.
    • Copy and store them in a save place. 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.

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.