Withings integration

How to integrate with the Withings API: ROOK simplifies access to Withings wearable data for health, fitness, and insurance apps.

Withings to Withings cloud to ROOK Connect to Your backend: how Withings data reaches your product through ROOK.

How it connects

ROOK connects to Withings through its cloud API.

ROOK's Withings Web API integration delivers body metrics, physical activity and sleep data from Withings devices as structured JSON, by webhook and API.

Utilize Withings data to personalize user experiences, driving increased engagement and retention.

Our Withings integration delivers notifications within minutes after a user completes an event and syncs their app.

Read the Withings docs
ROOK Connectphysical_summary · JSON
{  "data_structure": "physical_summary",  "user_id": "demo-user-01",  "physical_health": { "summary": { "physical_summary": {    "metadata": {      "sources_of_data_array": ["Withings"]    },    "distance": {      "steps_int": 8432,      "active_steps_int": 6120,      "walked_distance_meters_float": 6180.0    },    "activity": { "active_seconds_int": 3240 }  } } }}
ROOK Connectsleep_summary · JSON
{  "data_structure": "sleep_summary",  "user_id": "demo-user-01",  "sleep_health": { "summary": { "sleep_summary": {    "metadata": {      "sources_of_data_array": ["Withings"]    },    "duration": {      "sleep_duration_seconds_int": 26400,      "deep_sleep_duration_seconds_int": 6300,      "rem_sleep_duration_seconds_int": 5400    },    "heart_rate": { "hr_resting_bpm_int": 56 }  } } }}
ROOK Connectbody_summary · JSON
{  "data_structure": "body_summary",  "user_id": "demo-user-01",  "body_health": { "summary": { "body_summary": {    "metadata": {      "sources_of_data_array": ["Withings"]    },    "heart_rate": {      "hr_avg_bpm_int": 67,      "hr_resting_bpm_int": 58    },    "oxygenation": { "saturation_avg_percentage_int": 97 }  } } }}

Available data

The Withings data ROOK delivers.

Every field below comes from the Withings documentation and arrives in ROOK's standard structure, whatever device the user wears.

Physical health

physical summary12 fields

  • active_seconds_int
  • calories_expenditure_kcal_float
  • calories_net_active_kcal_float
  • floors_climbed_float
  • hr_avg_bpm_int
  • hr_maximum_bpm_int
  • hr_minimum_bpm_int
  • low_intensity_seconds_int
  • moderate_intensity_seconds_int
  • steps_int
  • traveled_distance_meters_float
  • vigorous_intensity_seconds_int

activity event20 fields

  • active_seconds_int
  • activity_duration_seconds_int
  • activity_end_datetime_string
  • activity_start_datetime_string
  • calories_net_active_kcal_float
  • floors_climbed_float
  • hr_avg_bpm_int
  • hr_maximum_bpm_int
  • hr_minimum_bpm_int
  • inactivity_seconds_int
  • low_intensity_seconds_int
  • moderate_intensity_seconds_int
  • rest_seconds_int
  • saturation_avg_percentage_int
  • steps_int
  • swimming_num_laps_int
  • swimming_num_strokes_float
  • swimming_pool_length_meters_float
  • traveled_distance_meters_float
  • vigorous_intensity_seconds_int

steps event1 field

  • accumulated_steps_int

Sleep health

sleep summary26 fields

  • breathing_granular_data_array
  • breaths_avg_per_min_int
  • breaths_maximum_per_min_int
  • breaths_minimum_per_min_int
  • deep_sleep_duration_seconds_int
  • hr_avg_bpm_int
  • hr_granular_data_array
  • hr_maximum_bpm_int
  • hr_minimum_bpm_int
  • hrv_avg_rmssd_float
  • hrv_avg_sdnn_float
  • hrv_rmssd_granular_data_array
  • hrv_sdnn_granular_data_array
  • light_sleep_duration_seconds_int
  • rem_sleep_duration_seconds_int
  • sleep_date_string
  • sleep_duration_seconds_int
  • sleep_efficiency_1_100_score_int
  • sleep_end_datetime_string
  • sleep_start_datetime_string
  • snoring_duration_total_seconds_int
  • snoring_events_count_int
  • snoring_granular_data_array
  • time_awake_during_sleep_seconds_int
  • time_in_bed_seconds_int
  • time_to_fall_asleep_seconds_int

Body health

body summary6 fields

  • bmi_float
  • height_cm_int
  • hr_avg_bpm_int
  • saturation_avg_percentage_int
  • temperature_avg_object
  • weight_kg_float

body metrics event3 fields

  • bmi_float
  • height_cm_int
  • weight_kg_float

heart rate event1 field

  • hr_avg_bpm_int

oxygenation event3 fields

  • saturation_avg_percentage_int
  • vo2max_mL_per_min_per_kg_int
  • device_source_data_array

blood pressure event2 fields

  • blood_pressure_avg_object
  • device_source_data_array

temperature event2 fields

  • temperature_avg_object
  • device_source_data_array

ecg event7 fields

  • start_datetime_string
  • end_datetime_string
  • duration_ms_float
  • hr_avg_bpm_int
  • sampling_frequency_hz_int
  • ecg_granular_data_array
  • device_source_data_array

Get started

Connect Withings in three steps.

  1. Enable Withings in the ROOK portalTurn Withings on as a data source for your client in the ROOK portal.
  2. Add Withings to your connections pageUsers pick Withings on the connections page and authorize ROOK with their Withings account.
  3. Receive standardized dataROOK turns Withings data into the same JSON structure as every other data source and delivers it to your backend by webhook and API.

Use cases

What teams build with Withings data.

From seamless wearable integrations to advanced health insights, ROOK empowers you to build personalized wellness apps, research platforms, fitness dashboards, chronic care solutions and many more great use cases.

More data sources

More data sources ROOK connects to through their cloud APIs.

FAQ

Frequently asked questions about the Withings integration

What teams ask before they connect Withings through ROOK.

What Withings data can I get through ROOK?

ROOK extracts 83 Withings fields covering physical activity, sleep and body and vital signs data, grouped into summaries and events. The data each user shares depends on the permissions they grant when they connect Withings.

How quickly does Withings data reach my backend?

Our Withings integration delivers notifications within minutes after a user completes an event and syncs their app.

Do I need my own Withings developer account?

No. ROOK handles the Withings connection, so you only enable Withings as a data source in the ROOK portal.

How does ROOK connect to Withings?

Through the Withings cloud API. Users authorize their Withings account once and ROOK keeps pulling new data, with no mobile development on your side.

Read the Withings documentation
Still have questions?Our team can review your sources and use case with you.
Schedule a demo

Articles on Withings from the ROOK blog

Build on better health data

Turn fragmented health data into your next product advantage.

Connect the sources your users rely on, standardize what comes back, and build workflows that respond to change.

Newsletter

Stay in the loop.

Sign up with your email address to receive news and updates from the ROOK team.

We respect your privacy. Read our privacy policy.