Zepp and structured workouts

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

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