Terra
Integrations
Research

Integration

API
Unified API
SDK
SDK
Authentication
Authentication
Streaming
Streaming
Blood
Blood Report API
Planned Workouts
Planned Workouts
AI Interface
AI Interface

User engagement

Graph API
Graph API
Scores
Health Scores
Rewards
Health Rewards

Use cases

Enterprise
Enterprise
Insurance
Insurance

Developers

Wearable Data
Wearable Data
Community
Community
Documentation
Documentation

Learn

Blog
Blog
Podcast
Podcast
Events
Events
Reports
Reports

Company

Customers
Customers
Careers
Careers
Partners
Partners
Support
Support
Pricing
Become an integrationGet started
IntegrationsResearch
Unified APIUnified APISDKSDKAuthenticationAuthenticationStreamingStreamingGraph APIGraph APIScoresScoresRewardsRewardsBlood Report APIBloodAI InterfaceAI Interface
EnterpriseEnterpriseInsuranceInsuranceWearable DataWearable DataCommunityCommunityDocumentationDocumentationBlogBlogPodcastPodcastEventsEventsReportsReportsCustomersCustomersCareersCareersPartnersPartnersSupportSupport
Pricing
Get startedBecome an integration


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
zap

Latest

zap

Popular

API

Unified API

SDK

Phone SDK

Authentication

Widget

Streaming

Streaming

Graph API

Graph API

App flow to retrieve wearable data

All

DeepBat23 months ago

I’m looking to connect our app to all fitness wearables. After setting it up, what is the process to request users permission to connect to their wearable device’s data? (e.g connecting it to Whoop data).

terra

Chandruadmin23 months ago

Hey there,

After a user connects one of their wearable device accounts to your Terra account, you will receive a user_id that uniquely identifies that device, something like efb43159-a1ab-4c4a-88bd-5100157a1e6b. Using this user ID, you can request for data from this user from your application's backend with a simple HTTP request like so (using python for this example):

The request above will return a json response containing a data payload that follows our daily data model.

Additionally, using Terra's destinations feature, you can have data from the users device/account directly sent to your backend or database as new data becomes available. For example, you can setup a webhook on your backend that will ingest Terra payloads. When a new user connects their device, you will receive a payload detailing the device and the user's id (and a reference_id that you can supply to identify them) and anytime they complete a workout or new steps gets synced with their device, we will send you a payload containing all the data for the day.

.

To see more regarding the methods of receiving data from Terra, checkout this section in our docs