> For the complete documentation index, see [llms.txt](https://docs.tryterra.co/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.tryterra.co/planned-workouts-api/pricing.md).

# Pricing

Planned Workouts is a paid add-on to your Terra plan, with usage measured in Planned Workouts credits.

## The add-on

Planned Workouts is available as an add-on to any Terra base plan for **$99/month**. Activate it from the dashboard, either on the Planned Workouts page itself or under **Settings → Plans & Pricing → Additional Products**.

Without the add-on active, every Planned Workouts REST endpoint returns `403 Forbidden` except deletes. You can still delete workout templates and planned workouts you created earlier.

## Credits

Usage is measured in **Planned Workouts credits**, a separate balance from your Unified API credits. Your subscription includes **20,000 Planned Workouts credits per month**. Beyond that, they are billed at **$0.005 each** (10 Planned Workouts credits = $0.05) at the end of each billing cycle, and **$0.003 each** past 1,000,000 in a month.

| Action                                                                                                                                 | Planned Workouts credits                         |
| -------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------ |
| **Push**: `POST /workouts/{workout_id}/plan` (sync a workout to a user's calendar)                                                     | 10 credits ($0.05)                               |
| **Push**: `PATCH /plannedWorkouts/{planned_workout_id}` (reschedule, re-syncs to the provider)                                         | 10 credits ($0.05)                               |
| **Push**: `PUT /workouts/{workout_id}` (update a template, re-sends each upcoming planned workout)                                     | 10 credits ($0.05) per `updated` planned workout |
| **Push**: `POST /routes/{route_id}/push` (send a [route](https://docs.tryterra.co/routes-api/overview.md) to a user's device)          | 10 credits ($0.05)                               |
| **Push**: `PUT /routes/{route_id}` (update a route, re-sends each pushed route)                                                        | 10 credits ($0.05) per `updated` pushed route    |
| **Push** (legacy): `POST /v2/plannedWorkout`                                                                                           | 10 credits per workout in `data`                 |
| **Pull**: `GET /plannedWorkouts?user_id=...` (one live read of the user's calendar, including workouts created on the provider's side) | 1 credit per request                             |
| Reads of Terra-stored workouts and routes, deletes, creating and reading templates, SDK sync polling                                   | Free                                             |

The 20,000 included Planned Workouts credits cover 2,000 pushes per month, or any mix of pushes and pulls.

Which of the two you can use depends on the provider. Intervals.icu is read-only for planned workouts, so an Intervals.icu connection only ever spends Planned Workouts credits on pulls. See [Provider compatibility](https://docs.tryterra.co/planned-workouts-api/provider-compatibility.md) for what each provider supports.

{% hint style="info" %}
Only successful operations are billed. A push the provider rejects costs nothing. A pull is billed once the live provider read completes. If the provider cannot be read, the response still returns your Terra-scheduled workouts with `X-Terra-Provider-Data-Truncated: true` and is free.
{% endhint %}
