Skip to content
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 12 additions & 0 deletions source/_integrations/withings.markdown
Original file line number Diff line number Diff line change
Expand Up @@ -77,6 +77,18 @@ Withings will validate (with HTTP HEAD) these requirements each time you save yo
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.

### Webhook requirements

For webhooks to work, your Home Assistant instance must be reachable by the Withings cloud service. The following requirements must be met:

- **Publicly accessible** - Your Home Assistant instance must be reachable from the internet
- **HTTPS on port 443** - Withings requires HTTPS specifically on port 443. Using HTTPS on a non-standard port (such as 8443) will not work
- **Valid SSL certificate** - The certificate must be signed by a globally recognized Certificate Authority (for example, Let's Encrypt). Self-signed certificates will not work

{% important %}
If webhooks cannot be established, some sensors will not be available. In particular, the sleep binary sensor has no polling fallback and requires working webhooks to function.
{% endimportant %}

## Available data

The {% term integration %} provides several entities, some of which are dynamically enabled if data is available.
Expand Down