• 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

FinalSurge API Integration

With Terra's FinalSurge web API integration, your app receives the sessions athletes and their coaches log in FinalSurge. Terra normalizes each workout, covering sport type, distance, duration, pace and heart rate, and POSTs it to your webhook.

Start Receiving Data From FinalSurge In 5 Minutes

FinalSurge

FinalSurge

Enable FinalSurge through your Terra dashboard

Select a Wearable

FinalSurge

FinalSurge

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 FinalSurge on your app or website

How the FinalSurge API integration works

Data delivery
Terra polls FinalSurge
Expected latency
Up to 5–10 minutes after the provider syncs
Data types
Activity
Credentials
No provider credentials required

Two ways to receive FinalSurge data

When data is available from a FinalSurge 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.

FinalSurge 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.

FinalSurge'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

FinalSurge's Available Data Types

Activity Payload (JSON)

{

active_durations_data: { ... }

calories_data: { ... }

data_enrichment: { ... }

distance_data: { ... }

energy_data: { ... }

heart_rate_data: { ... }

metadata: { ... }

movement_data: { ... }

work_data: { ... }

}

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

Send FinalSurge 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 FinalSurge training data through an API?

Your user connects their FinalSurge account through the Terra widget, and the sessions they and their coach log are read by Terra, normalized into standard Activity payloads and POSTed to your webhook.

How quickly does FinalSurge data reach my app?

Terra polls FinalSurge every 5–10 minutes for each connected user, so new data reaches your webhook within that window of a device sync.

What data is available from FinalSurge through Terra?

Through Terra's FinalSurge integration, you can access activity data.

What does a FinalSurge workout payload contain?

Terra normalizes each logged session down to sport type, distance, duration, pace and heart rate, so a coached FinalSurge workout parses with the same code as a workout straight off a watch.

Do I need FinalSurge API credentials?

No provider credentials are required. Users authenticate with their own FinalSurge login through the Terra widget.

Can't Find Your Question?

What devices are supported?

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

FinalSurge

Connect with our FinalSurge Integration

FinalSurge API alternatives

These integrations also offer Activity data.

Strava

Strava

Zwift

Zwift

Catapult One

Catapult One

Concept2

Concept2

Decathlon

Decathlon

Hammerhead

Hammerhead

iFit

iFit

Insiders

Insiders

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