home-assistant.io/source/_integrations/withings.markdown

title, description, ha_category, ha_release, ha_iot_class, ha_config_flow, ha_codeowners, ha_domain, ha_platforms, ha_integration_type, ha_quality_scale

title	description	ha_category	ha_release	ha_iot_class	ha_config_flow	ha_codeowners	ha_domain	ha_platforms	ha_integration_type	ha_quality_scale
Withings	Instructions on how to integrate Withings health products within Home Assistant.	Health Sensor	0.99	Cloud Push	true	@joostlek	withings	binary_sensor calendar diagnostics sensor	integration	platinum

The Withings {% term integration %} 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

4. 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.

{% details "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.

{% enddetails %}

{% include integrations/config_flow.md %}

Data updates

The {% term integration %} automatically detects if you can use webhooks. This enables the {% term integration %} only to update when there is new data. The binary sensor for sleep will only work if the {% term integration %} can establish webhooks with Withings.

Available data

The {% term integration %} 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 {% term integration %} 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.