Today's Plan API Integration

With Terra's TodaysPlan web API integration, your app receives the sessions athletes complete against their TodaysPlan schedule. Terra normalizes each workout, covering sport type, distance, duration, power where relevant and heart rate, and POSTs it to your webhook.

Start Receiving Data From Today's Plan In 5 Minutes

Today's Plan

Enable Today's Plan through your Terra dashboard

Select a Wearable

Today's Plan

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 Today's Plan on your app or website

How the Today's Plan API integration works

Data delivery: Terra polls Today's Plan
Expected latency: Up to 5–10 minutes after the provider syncs
Data types: , normalized by the Terra unified API
Credentials: No provider credentials required

Two ways to receive Today's Plan data

When data is available from a Today's Plan 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.

Today's Plan 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.

Send Today's Plan 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 Blob

People Often Ask Us...

How do I access Today's Plan session data through an API?

Your user connects their Today's Plan account through the Terra widget, and Terra reads the sessions they complete against their schedule, normalizing each workout into a standard Activity payload delivered to your webhook.

How quickly does Today's Plan data reach my app?

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

What does a Today's Plan workout payload contain?

Sport type, distance, duration, heart rate, and power where the sport reports it — the completed side of a planned session, in the same shape as any other Terra activity.

Do I need Today's Plan API credentials?

No provider credentials are required. Athletes authenticate with their own Today's Plan login through the Terra widget.

Can't Find Your Question?

What devices are supported?

Terra API integrates with any Today's Plan device currently supported by Today's Plan.

TodaysPlan

Connect with our Today's Plan Integration

Ask, Learn, and Connect

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

Ask a Question

Become an integration Get started

Today's Plan API Integration

Start Receiving Data From Today's Plan In 5 Minutes

Today's Plan

Enable Today's Plan through your Terra dashboard

Select a Wearable

Today's Plan

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 Today's Plan on your app or website

How the Today's Plan API integration works

Data delivery: Terra polls Today's Plan
Expected latency: Up to 5–10 minutes after the provider syncs
Data types: , normalized by the Terra unified API
Credentials: No provider credentials required

Two ways to receive Today's Plan data

Today's Plan 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.

Send Today's Plan 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 Blob

People Often Ask Us...

How do I access Today's Plan session data through an API?

How quickly does Today's Plan data reach my app?

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

What does a Today's Plan workout payload contain?

Sport type, distance, duration, heart rate, and power where the sport reports it — the completed side of a planned session, in the same shape as any other Terra activity.

Do I need Today's Plan API credentials?

No provider credentials are required. Athletes authenticate with their own Today's Plan login through the Terra widget.

Can't Find Your Question?

What devices are supported?

Terra API integrates with any Today's Plan device currently supported by Today's Plan.

TodaysPlan

Connect with our Today's Plan Integration

Ask, Learn, and Connect

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

Ask a Question

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