← providers

Withings

API docs ↗

Access health metrics from Withings devices — weight, body composition, blood pressure, heart rate, sleep, and activity

skill: withings ↗

Endpoints

Call these through the okoro proxy at https://okoro.ai/p/withings

ActionMethodPathMin scope
Get body measurementsPOSTread
Get activity dataPOSTread
Get sleep dataPOSTread
Get heart rate / ECG dataPOSTread
Get user infoPOSTread
Manage notificationsPOSTread

Examples

Every request requires a short-lived operation token scoped to a single action.

1. Get an operation token

Exchange your service token for a short-lived operation token scoped to a single action.

TOKEN=$(curl -sX POST "https://okoro.ai/t/tokens" \
  -H "Authorization: Bearer $OKORO_SERVICE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"provider": "withings", "scope": "read", "intent": "describe what you are doing"}' \
  | jq -r '.token')

2. Call the API

Use the operation token as a Bearer token. The proxy forwards the request to Withings and logs the action.

Get body measurements
curl -X POST "https://okoro.ai/p/withings/measure" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'
Get activity data
curl -X POST "https://okoro.ai/p/withings/v2/measure" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'
Get sleep data
curl -X POST "https://okoro.ai/p/withings/v2/sleep" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'
Get heart rate / ECG data
curl -X POST "https://okoro.ai/p/withings/v2/heart" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'
Get user info
curl -X POST "https://okoro.ai/p/withings/v2/user" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'
Manage notifications
curl -X POST "https://okoro.ai/p/withings/v2/notify" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

Scopes

Your service token must be configured with at least the required scope level.

read
POST
/measure /v2/measure /v2/sleep /v2/heart /v2/user
write
POST
/measure /v2/measure /v2/sleep /v2/heart /v2/user /v2/notify
update
POST
/measure /v2/measure /v2/sleep /v2/heart /v2/user /v2/notify
delete
POST
/measure /v2/measure /v2/sleep /v2/heart /v2/user /v2/notify
all
GET POST PUT PATCH DELETE
/**

Skill

A Claude Code skill for Withings — token caching, scope enforcement, and audit logging built in.

withings
View the skill, browse files, and get install instructions →