Start Receiving Data From MacrosFirst In 5 Minutes
MacrosFirst
Enable MacrosFirst through your Terra dashboard
Select a Wearable
MacrosFirst
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 MacrosFirst on your app or website
How the MacrosFirst API integration works
- Data delivery
- Terra polls MacrosFirst
- Expected latency
- Up to 5–10 minutes after the provider syncs
- Data types
- Body and Nutrition
- Credentials
- Terra manages the MacrosFirst API credentials, so there is nothing to register
Two ways to receive MacrosFirst data
When data is available from a MacrosFirst 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.
MacrosFirst does not notify Terra when data changes, so Terra polls it every 5–10 minutes for each connected user and POSTs the normalized payload to your webhook.
MacrosFirst's Body
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
Body Payload (JSON)
{
metadata: { ... }
}
Data can also be sent as a FIT File or with the FHIR Format.
Send MacrosFirst data to your backend
Terra forwards every normalized payload to the destination you already use.
Webhook
Firestore
SQL
Mongo DB
Google Cloud Storage Bucket
AWS S3 Bucket
AWS Simple Queue Service
Kafka
Supabase
Azure BlobPeople Often Ask Us...
Can't Find Your Question?
What devices are supported?
Terra API integrates with any MacrosFirst device currently supported by MacrosFirst.
MacrosFirst API alternatives
These integrations cover some of the same data types.
Cookie Preferences
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.