• Unified API
  • Mobile SDK
  • Connection Widget
  • Streaming
  • Blood Report API
  • Graph API
  • Health Scores
  • Health Rewards
  • Planned Workouts
  • Lab Testing
  • AI Interface
  • Enterprise
  • Insurance
  • Integrations
  • Research
  • Podcast
  • Blog
  • Reports
  • Events
  • Documentation
  • Community
  • Wearable Data
  • About
  • Customers
  • Partners
  • Careers
  • Support
  • Pricing
Terra
Pricing
Become an integrationGet started

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

Zepp and structured workouts

All

SuddenSquid3 weeks ago

Currently I can't send planned / structured workouts to Zepp devices. They are certainly capable of receiving it (they have integration with Training Peaks for this purpose, for instance). Any way that I can make this happen?

SuddenSquid3 weeks ago

When I say workout I mean ("running workout"), with blocks, zones, etc

terra

Vanessaadmin3 weeks ago

Hi Pedro,

Yes, you can send planned and structured workouts to Zepp devices through Terra's Planned Workouts API. Zepp is supported for running, trail running, cycling, and swimming, with create, update, and delete operations.

One important constraint to know about up front: Zepp uses a 7-day sync window. Workouts only appear on the device when scheduled within the next 7 days (today to today + 6). If you schedule something further out, it gets stored on Terra's side but won't push to the watch until a subsequent write or delete for that user triggers a window refresh. So if you're laying out a training calendar weeks in advance, you'll want to either re-sync as dates roll into range, or schedule within the week.

The flow is two-phase: create a workout template once, then schedule it to a user with athlete-specific parameters.

On targets, Zepp accepts heart rate and power as absolute values, percent of max or threshold, and zones, plus pace and speed. Cadence works only as a secondary target alongside a primary (HR, power, pace, or speed).

A few Zepp limitations worth flagging:

  • No strength training
  • No swim stroke types or equipment weight targets (silently coerced with a warning)
  • No retrieve operation, so you'll want to persist the workout IDs Terra returns on your side
  • Unsupported sports default to running with a coercion warning

The API is in pre-release, so the docs are still being filled in. The provider compatibility page covers all the Zepp specifics if you want to dig deeper: https://docs.tryterra.co/planned-workouts-api/overview/provider-compatibility