Connect Withings
Link your Withings account to pull weight and body composition measurements directly into VitalTrends. Every weigh-in syncs automatically.
Steps
An active subscription is required to connect integrations. Go to Pricing to get started.
Go to Settings → Connections. You will see a Withings card showing "Not connected".
You will be redirected to Withings's OAuth authorization page. Log in with your Withings account credentials if prompted.
Review the permissions and click Allow this app. VitalTrends requests read-only access to your measurements.
A background job imports up to 12 months of weight and body composition history. The dashboard will populate once the sync completes.
How data stays fresh
Webhooks (real-time)
Withings sends a push notification each time you weigh yourself. VitalTrends processes body composition (appli=1) and vitals (appli=4) events immediately after your scale uploads the measurement.
Catch-up sync (background)
An hourly job checks whether your Withings data is stale (no new data in 24 hours). Stale accounts trigger a catch-up sync to fetch any missed measurements.
Disconnecting Withings
Go to Settings → Connections and click Disconnect next to Withings. This stops all future syncs. Your historical measurement data stays in VitalTrends.
Troubleshooting
No data after connecting
The initial import is still running. Wait a minute and refresh. If measurements still do not appear, try disconnecting and reconnecting.
Connection shows "Reconnection needed"
Withings OAuth tokens expire or can be revoked. Click Reconnect on the Connections page to re-authorize. This happens automatically if you revoke access in the Withings app.
Weight appears in wrong unit
VitalTrends stores weight in kilograms (as provided by the Withings API) and converts to your preferred unit based on your profile settings. Check Settings → Profile to update your unit preference.