• Unified API
  • Mobile SDK
  • Connection Widget
  • Streaming
  • Lab Reports API
  • Graph API
  • Health Scores
  • Health Rewards
  • Planned Workouts
  • Lab Testing
  • AI Interface
  • Enterprise
  • Insurance
  • Integrations
  • Research
  • Podcast
  • Blog
  • Reports
  • Events
  • Documentation
  • Community
  • Example apps
  • Wearable Data
  • About
  • Customers
  • Partners
  • Careers
  • Support
  • Pricing
Terra
Pricing
Become an integrationGet started

Withings API Integration

With Terra's Withings web API integration, you can gather data from withings scales, watches, and more. FDA-cleared data can be provided to you through the Withings API integration, such as Atrial Fibrillation classification, detailed Heart Rate, and various body measurements

Start Receiving Data From Withings In 5 Minutes

Withings

Withings

Enable Withings through your Terra dashboard

Select a Wearable

Withings

Withings

Connect users to your app

0. "active_durations_data":{...}
1. "calories_data": {...}
2. "device_data": {...}
3. "distance_data": {...}
4. "heart_rate_data": {...}
5. "movement_data": {...}
6. "position_data": {...}

Start receiving data from Withings on your app or website

How the Withings API integration works

Data delivery
Withings pushes to Terra on change
Expected latency
Seconds after the provider syncs
Data types
Activity, Body, Daily and Sleep
Credentials
Terra manages the Withings API credentials, so there is nothing to register

Two ways to receive Withings data

When data is available from a Withings device, Terra sends it straight to your webhook. During your Terra account setup you'll be prompted for a callback URL, and that is where Terra POSTs each payload.

Withings notifies Terra as soon as new data is available, and we POST the normalized payload straight to your webhook. No polling needed.

Withings's Activity
Payload Preview

Terra API preserves the raw data from the wearable, it just standardizes the units and the json format. It doesn’t augment or change the raw data in any way.

Data is organized into one of 6 data types.

Learn More

Withings's Available Data Types

Activity Payload (JSON)

{

active_durations_data: { ... }

data_enrichment: { ... }

distance_data: { ... }

heart_rate_data: { ... }

metadata: { ... }

movement_data: { ... }

oxygen_data: { ... }

}

Data can also be sent as a FIT File or with the FHIR Format.

Send Withings data to your backend

Terra forwards every normalized payload to the destination you already use.
WebhookWebhook
FirestoreFirestore
SQLSQL
Mongo DBMongo DB
Google Cloud Storage BucketGoogle Cloud Storage Bucket
WebhookWebhook
FirestoreFirestore
SQLSQL
Mongo DBMongo DB
Google Cloud Storage BucketGoogle Cloud Storage Bucket
AWS S3 BucketAWS S3 Bucket
AWS Simple Queue ServiceAWS Simple Queue Service
KafkaKafka
SupabaseSupabase
Azure BlobAzure Blob
AWS S3 BucketAWS S3 Bucket
AWS Simple Queue ServiceAWS Simple Queue Service
KafkaKafka
SupabaseSupabase
Azure BlobAzure Blob

People Often Ask Us...

How do I access Withings data through the Terra API?

Withings is a web API integration. Your user connects their Withings account once through the Terra widget, and every device tied to that account reports through it — smart scales, the ScanWatch range, and BPM blood pressure monitors. Terra normalizes each payload and POSTs it to your webhook, and you can also pull it over the Terra REST API.

How quickly does Withings data reach my app?

Withings notifies Terra as soon as new data is available, so the normalized payload reaches your webhook within seconds of the user's device syncing.

What data is available from Withings through Terra?

Through Terra's Withings integration, you can access activity, body, daily and sleep data.

Can I get Withings' FDA-cleared measurements through the API?

Yes. The Withings integration surfaces FDA-cleared readings including atrial fibrillation classification, alongside detailed heart rate and the full set of body measurements from Withings scales. They arrive inside Terra's normalized Body payload rather than in a Withings-specific shape.

Do I need a Withings developer account?

No. Terra manages the Withings API credentials, so there is nothing for you to register on the Withings developer dashboard. Your users authorize with their own Withings login.

How much does the Withings API integration cost?

Withings is included in every Terra plan — integrations are unlimited and never charged per provider. Pricing is credit-based, with 100,000 credits included monthly and usage-based rates after that, backed by a 30-day money-back guarantee.

Can't Find Your Question?

What devices are supported?

Terra API integrates with any Withings device currently supported by Withings.

ScanWatch
Horizon
Steel HR
Move ECG
BPM core
BPM connect
ScanWatch Nova
ScanWatch 2

Connect with our Withings Integration

Withings API alternatives

These integrations also offer Activity, Body, Daily and Sleep data.

Garmin

Garmin

Oura

Oura

Samsung

Samsung

Huawei

Huawei

Biostrap

Biostrap

WHOOP

WHOOP

TrainingPeaks

TrainingPeaks

Fitbit

Fitbit

Ask, Learn, and Connect

Explore the community forum and connect to Terra API with ease.

Ask a Question

The world's best health apps run on Terra data

Get started
ProductsIntegrations AI Interface Authentication Mobile Development Documentation GraphAPI
DocumentationAPI SDK Quickstart
CommunityBlog Research Community Podcast Github
CompanyAboutCareersCustomersBecome an IntegrationCookies PolicyGDPRPrivacy PolicyTerms of Purchase
© Terra API. 2026 — All rights reserved.

Cookie Preferences

Essential CookiesAlways On
Advertisement Cookies
Analytics Cookies

Crunch Time: Embrace the Cookie Monster Within!

We use cookies to enhance your browsing experience and analyse our traffic. By clicking “Accept All”, you consent to our use of cookies according to our Cookie Policy. You can change your mind any time by visiting out cookie policy.

Cookies Policy