Zwift API Integration
Start Receiving Data From Zwift In 5 Minutes
Zwift
Enable Zwift through your Terra dashboard
Select a Wearable
Zwift
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 Zwift on your app or website
How the Zwift API integration works
- Data delivery
- Terra polls Zwift
- Expected latency
- Up to 5–10 minutes after the provider syncs
- Data types
- Activity, normalized by the Terra unified API
- Credentials
- No provider credentials required
Two ways to receive Zwift data
When data is available from a Zwift 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.
Zwift 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.
Zwift'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
Activity Payload (JSON)
{
active_durations_data: { ... }
calories_data: { ... }
data_enrichment: { ... }
distance_data: { ... }
heart_rate_data: { ... }
metadata: { ... }
movement_data: { ... }
position_data: { ... }
power_data: { ... }
}
Data can also be sent as a FIT File or with the FHIR Format.
Send Zwift 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 Zwift device currently supported by Zwift.
Terra on Zwift
Research and writing from the Terra team on Zwift.
- Podcast12 May 2023
Podcast with Eric Min, Co-founder of Zwift
Podcast with Eric Min, Co-founder of Zwift In this podcast, we connected with Eric Min, Co-founder of Zwift. Below are some highlights of the conversation Listen on Spo
Kyriakos Eleftheriou
- Research9 Apr 2026
How The Fittest Do Winter
We analyzed 856,000 exercise sessions from Europeans across 20 countries to find out how people really train across the year. The data reveals three distinct exerciser phenotypes — and an entire category of athlete that didn't exist a decade ago, invented by indoor cycling platforms like Zwift.
Alistair Brownlee
Zwift API alternatives
These integrations also offer Activity data.
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.