REST API reference

TrueCoach API

15 endpoints for TrueCoach. Each one is a POST with a JSON body, called with your API key.

Base URL
https://cotlet.dev/api/v1/truecoach
Connects with
Your own TrueCoach coach account (on a Team Account, the coach whose clients and programs you want to use)
Integration page
TrueCoach
TrueCoach Endpoints
Endpoint Access Description
list_clients read Your clients with client type, groups, 7, 30 and 90 day compliance rates and due date.
get_client read One client: profile, client type, groups, compliance rates, due date and assigned programs.
get_dashboard read Your overall compliance rate, clients under Needs Attention and clients due soon.
list_workouts read Workouts on a client's workout calendar in a date range, with status.
get_workout read Full workout: title, warmup, exercises and circuits, cooldown, and the results the client logged.
list_programs read Programs in your account with tags and the clients they are assigned to.
list_metrics read A client's metrics (for example back squat or body fat %) with their values over time.
list_messages read Recent messages in your conversation with a client, newest first.
create_client write Add a client. Remote and Dual clients get the TrueCoach invitation email right away.
create_workout write Write a workout on a client's workout calendar for a given day.
assign_program write Put a program on the workout calendars of clients or client groups.
unassign_program write Remove a program from a client's calendar. Completed and missed workouts stay.
add_client_to_group write Add a client to one of your client groups. A client can be in several groups.
update_metric write Record a new value for one of a client's metrics.
send_message write Message a client or every client in a group, as you.

List clients

read

POST https://cotlet.dev/api/v1/truecoach/list_clients

Returns one item per client, active clients by default. Compliance is completed against assigned exercises, as TrueCoach shows it. Due date is the date of the furthest programmed workout. Results come in pages; use the cursor for the next one.

Parameters

Parameters: list_clients
NameTypeDescription
group string Only clients in this client group.
client_type enum remote, dual or in_person. Default: all.
archived boolean List archived clients instead of active ones. Default: false.
limit integer Page size. Default: 50.
cursor string Next page cursor from the previous call.

Request

cURL
curl -X POST https://cotlet.dev/api/v1/truecoach/list_clients \
  -H "Authorization: Bearer $COTLET_API_KEY"
Python
result = client.call("truecoach", "list_clients")
Node.js
const result = await cotlet.call('truecoach', 'list_clients');
CLI
cotlet call truecoach list_clients

Example response

{
  "clients": [
    {
      "client_id": "4821907",
      "name": "Sam Rivera",
      "client_type": "remote",
      "groups": [
        "Bootcamp"
      ],
      "compliance_7d": 50,
      "compliance_30d": 82,
      "compliance_90d": 88,
      "due_date": "2026-10-18"
    },
    {
      "client_id": "4821955",
      "name": "Alex Kim",
      "client_type": "dual",
      "groups": [
        "Bootcamp",
        "January"
      ],
      "compliance_7d": 100,
      "compliance_30d": 95,
      "compliance_90d": 91,
      "due_date": "2026-11-02"
    }
  ],
  "next_cursor": null
}

Get client

read

POST https://cotlet.dev/api/v1/truecoach/get_client

Returns the profile fields TrueCoach holds for the client, the three compliance rates and the programs assigned to them. In-Person clients have no client account, so they have no login. Archived clients can be read too.

Parameters

Parameters: get_client
NameTypeDescription
client_id required string Client ID from list_clients.

Request

cURL
curl -X POST https://cotlet.dev/api/v1/truecoach/get_client \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"client_id":"client_8c41d2"}'
Python
result = client.call("truecoach", "get_client", {"client_id":"client_8c41d2"})
Node.js
const result = await cotlet.call('truecoach', 'get_client', {"client_id":"client_8c41d2"});
CLI
cotlet call truecoach get_client --data '{"client_id":"client_8c41d2"}'

Example response

{
  "client_id": "4821907",
  "name": "Sam Rivera",
  "email": "sam.rivera@example.com",
  "client_type": "remote",
  "groups": [
    "Bootcamp"
  ],
  "compliance_7d": 50,
  "compliance_30d": 82,
  "compliance_90d": 88,
  "due_date": "2026-10-18",
  "programs": [
    {
      "program_id": "30517",
      "name": "12 Week Hypertrophy"
    }
  ]
}

Get dashboard

read

POST https://cotlet.dev/api/v1/truecoach/get_dashboard

Returns what the TrueCoach dashboard shows. Needs Attention lists clients whose compliance rate dropped suddenly in a period. Due soon uses the threshold set in your TrueCoach settings.

Parameters

No parameters.

Request

cURL
curl -X POST https://cotlet.dev/api/v1/truecoach/get_dashboard \
  -H "Authorization: Bearer $COTLET_API_KEY"
Python
result = client.call("truecoach", "get_dashboard")
Node.js
const result = await cotlet.call('truecoach', 'get_dashboard');
CLI
cotlet call truecoach get_dashboard

Example response

{
  "overall_compliance": 84,
  "needs_attention": [
    {
      "client_id": "4821907",
      "name": "Sam Rivera",
      "period": "7d",
      "compliance": 50
    }
  ],
  "due_soon": [
    {
      "client_id": "4821907",
      "name": "Sam Rivera",
      "due_date": "2026-10-18"
    }
  ]
}

List workouts

read

POST https://cotlet.dev/api/v1/truecoach/list_workouts

Returns workouts oldest first with date, title and status. A day can hold more than one workout. Use get_workout for the exercises and logged results.

Parameters

Parameters: list_workouts
NameTypeDescription
client_id required string Client ID from list_clients.
from required date First day of the range.
to required date Last day of the range.
status enum all, completed, missed or upcoming. Default: all.

Request

cURL
curl -X POST https://cotlet.dev/api/v1/truecoach/list_workouts \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"client_id":"client_8c41d2","from":"2026-10-01","to":"2026-10-01"}'
Python
result = client.call("truecoach", "list_workouts", {"client_id":"client_8c41d2","from":"2026-10-01","to":"2026-10-01"})
Node.js
const result = await cotlet.call('truecoach', 'list_workouts', {"client_id":"client_8c41d2","from":"2026-10-01","to":"2026-10-01"});
CLI
cotlet call truecoach list_workouts --data '{"client_id":"client_8c41d2","from":"2026-10-01","to":"2026-10-01"}'

Example response

{
  "workouts": [
    {
      "workout_id": "91374520",
      "date": "2026-10-08",
      "title": "Upper body A",
      "status": "completed"
    },
    {
      "workout_id": "91374611",
      "date": "2026-10-10",
      "title": "Lower body B",
      "status": "missed"
    }
  ]
}

Get workout

read

POST https://cotlet.dev/api/v1/truecoach/get_workout

Returns the parts in the order the client sees them. Results are what the client entered; for In-Person clients, the coach entered them. A missed workout has no results.

Parameters

Parameters: get_workout
NameTypeDescription
workout_id required string Workout ID from list_workouts.

Request

cURL
curl -X POST https://cotlet.dev/api/v1/truecoach/get_workout \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"workout_id":"workout_8c41d2"}'
Python
result = client.call("truecoach", "get_workout", {"workout_id":"workout_8c41d2"})
Node.js
const result = await cotlet.call('truecoach', 'get_workout', {"workout_id":"workout_8c41d2"});
CLI
cotlet call truecoach get_workout --data '{"workout_id":"workout_8c41d2"}'

Example response

{
  "workout_id": "91374520",
  "client_id": "4821907",
  "date": "2026-10-08",
  "title": "Upper body A",
  "status": "completed",
  "warmup": "5 min row, band pull-aparts",
  "items": [
    {
      "type": "exercise",
      "name": "Bench Press",
      "description": "4 sets of 6, rest 2 min",
      "results": "4x6 at 80 kg"
    },
    {
      "type": "exercise",
      "name": "Pull-up",
      "description": "3 sets to near failure",
      "results": "8, 7, 6"
    }
  ],
  "cooldown": "5 min easy walk"
}

List programs

read

POST https://cotlet.dev/api/v1/truecoach/list_programs

Returns your programs, filtered by program tag if you give one. On Team Accounts, private programs are visible only to coaches with admin privileges.

Parameters

Parameters: list_programs
NameTypeDescription
tag string Only programs with this program tag.

Request

cURL
curl -X POST https://cotlet.dev/api/v1/truecoach/list_programs \
  -H "Authorization: Bearer $COTLET_API_KEY"
Python
result = client.call("truecoach", "list_programs")
Node.js
const result = await cotlet.call('truecoach', 'list_programs');
CLI
cotlet call truecoach list_programs

Example response

{
  "programs": [
    {
      "program_id": "30517",
      "name": "12 Week Hypertrophy",
      "tags": [
        "strength"
      ],
      "weeks": 12,
      "assigned_clients": 6
    },
    {
      "program_id": "30644",
      "name": "Bootcamp Base",
      "tags": [
        "group"
      ],
      "weeks": 4,
      "assigned_clients": 11
    }
  ]
}

List metrics

read

POST https://cotlet.dev/api/v1/truecoach/list_metrics

Returns the metrics assigned to the client, grouped as in the Metric Manager, with each recorded value and date, newest first. Metrics linked to a workout exercise update when the client logs a result.

Parameters

Parameters: list_metrics
NameTypeDescription
client_id required string Client ID from list_clients.

Request

cURL
curl -X POST https://cotlet.dev/api/v1/truecoach/list_metrics \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"client_id":"client_8c41d2"}'
Python
result = client.call("truecoach", "list_metrics", {"client_id":"client_8c41d2"})
Node.js
const result = await cotlet.call('truecoach', 'list_metrics', {"client_id":"client_8c41d2"});
CLI
cotlet call truecoach list_metrics --data '{"client_id":"client_8c41d2"}'

Example response

{
  "client_id": "4821907",
  "metrics": [
    {
      "name": "Back Squat",
      "unit": "kg",
      "values": [
        {
          "date": "2026-10-08",
          "value": "110"
        },
        {
          "date": "2026-09-10",
          "value": "105"
        }
      ]
    }
  ]
}

List messages

read

POST https://cotlet.dev/api/v1/truecoach/list_messages

Returns text messages with sender and time. Reading does not mark anything as sent or change the conversation.

Parameters

Parameters: list_messages
NameTypeDescription
client_id required string Client ID from list_clients.
limit integer Number of messages. Default: 30.

Request

cURL
curl -X POST https://cotlet.dev/api/v1/truecoach/list_messages \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"client_id":"client_8c41d2"}'
Python
result = client.call("truecoach", "list_messages", {"client_id":"client_8c41d2"})
Node.js
const result = await cotlet.call('truecoach', 'list_messages', {"client_id":"client_8c41d2"});
CLI
cotlet call truecoach list_messages --data '{"client_id":"client_8c41d2"}'

Example response

{
  "client_id": "4821907",
  "messages": [
    {
      "sender": "client",
      "sent_at": "2026-10-10T18:42:00+02:00",
      "body": "Sorry, travelling this week."
    },
    {
      "sender": "coach",
      "sent_at": "2026-10-08T09:10:00+02:00",
      "body": "Great session yesterday."
    }
  ]
}

Create client

write Confirm

POST https://cotlet.dev/api/v1/truecoach/create_client

Creates the client in your list. First and last name are required; email is required for remote and dual clients. In-Person clients get no invitation and no account. A client who already has a TrueCoach account under another coach cannot be added with the same email. By default you confirm each call; you can switch that off for this tool.

Parameters

Parameters: create_client
NameTypeDescription
first_name required string First name.
last_name required string Last name.
email string Required for remote and dual clients.
client_type enum remote, dual or in_person. Default: remote.

Request

cURL
curl -X POST https://cotlet.dev/api/v1/truecoach/create_client \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"first_name":"Maya","last_name":"Okafor","email":"maya.okafor@example.com","client_type":"remote"}'
Python
result = client.call("truecoach", "create_client", {"first_name":"Maya","last_name":"Okafor","email":"maya.okafor@example.com","client_type":"remote"})
Node.js
const result = await cotlet.call('truecoach', 'create_client', {"first_name":"Maya","last_name":"Okafor","email":"maya.okafor@example.com","client_type":"remote"});
CLI
cotlet call truecoach create_client --data '{"first_name":"Maya","last_name":"Okafor","email":"maya.okafor@example.com","client_type":"remote"}'

Example response

{
  "client_id": "4822040",
  "name": "Maya Okafor",
  "client_type": "remote",
  "invitation_sent": true
}

Create workout

write

POST https://cotlet.dev/api/v1/truecoach/create_workout

Adds the workout to the calendar and returns its ID. Warmup and cooldown are free text. Sets, reps, tempo and rest go in each exercise description. Exercise names come from the TrueCoach library. It does not ask for your OK: the client sees the workout on their calendar, but you can edit or delete it in TrueCoach.

Parameters

Parameters: create_workout
NameTypeDescription
client_id required string Client ID from list_clients.
date required date Day on the workout calendar.
title string Workout title the client sees.
warmup string Warmup text, shown as written.
items required object Ordered list of exercises (name, description, optional superset link) and circuits (description).
cooldown string Cooldown text, shown as written.

Request

cURL
curl -X POST https://cotlet.dev/api/v1/truecoach/create_workout \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"client_id":"4821907","date":"2026-10-15","title":"Lower body A","warmup":"5 min bike, 2 rounds: 10 glute bridges, 10 goblet squats","items":[{"type":"exercise","name":"Back Squat","description":"5 sets of 5, tempo 3010, rest 2 min"},{"type":"exercise","name":"Romanian Deadlift","description":"3 sets of 8, rest 90 s"},{"type":"circuit","description":"10 min EMOM: 12 KB swings, 8 push-ups"}],"cooldown":"5 min easy walk, hip flexor stretch"}'
Python
result = client.call("truecoach", "create_workout", {"client_id":"4821907","date":"2026-10-15","title":"Lower body A","warmup":"5 min bike, 2 rounds: 10 glute bridges, 10 goblet squats","items":[{"type":"exercise","name":"Back Squat","description":"5 sets of 5, tempo 3010, rest 2 min"},{"type":"exercise","name":"Romanian Deadlift","description":"3 sets of 8, rest 90 s"},{"type":"circuit","description":"10 min EMOM: 12 KB swings, 8 push-ups"}],"cooldown":"5 min easy walk, hip flexor stretch"})
Node.js
const result = await cotlet.call('truecoach', 'create_workout', {"client_id":"4821907","date":"2026-10-15","title":"Lower body A","warmup":"5 min bike, 2 rounds: 10 glute bridges, 10 goblet squats","items":[{"type":"exercise","name":"Back Squat","description":"5 sets of 5, tempo 3010, rest 2 min"},{"type":"exercise","name":"Romanian Deadlift","description":"3 sets of 8, rest 90 s"},{"type":"circuit","description":"10 min EMOM: 12 KB swings, 8 push-ups"}],"cooldown":"5 min easy walk, hip flexor stretch"});
CLI
cotlet call truecoach create_workout --data '{"client_id":"4821907","date":"2026-10-15","title":"Lower body A","warmup":"5 min bike, 2 rounds: 10 glute bridges, 10 goblet squats","items":[{"type":"exercise","name":"Back Squat","description":"5 sets of 5, tempo 3010, rest 2 min"},{"type":"exercise","name":"Romanian Deadlift","description":"3 sets of 8, rest 90 s"},{"type":"circuit","description":"10 min EMOM: 12 KB swings, 8 push-ups"}],"cooldown":"5 min easy walk, hip flexor stretch"}'

Example response

{
  "workout_id": "91374700",
  "client_id": "4821907",
  "date": "2026-10-15",
  "title": "Lower body A",
  "status": "upcoming",
  "items": 3,
  "due_date": "2026-10-18"
}

Assign program

write

POST https://cotlet.dev/api/v1/truecoach/assign_program

Assigns from the start date on the program day you choose. Completed and missed workouts are never touched. Later edits to the program reach clients only if Sync is on for that program in TrueCoach. It does not ask for your OK, because unassign_program undoes it.

Parameters

Parameters: assign_program
NameTypeDescription
program_id required string Program ID from list_programs.
client_ids string[] Clients to assign. Give this or group_names.
group_names string[] Client groups to assign.
start_date required date Calendar date of the first workout.
start_day integer Program day to start on. Default: 1.

Request

cURL
curl -X POST https://cotlet.dev/api/v1/truecoach/assign_program \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"program_id":"30517","group_names":["Bootcamp"],"start_date":"2026-10-19","start_day":1}'
Python
result = client.call("truecoach", "assign_program", {"program_id":"30517","group_names":["Bootcamp"],"start_date":"2026-10-19","start_day":1})
Node.js
const result = await cotlet.call('truecoach', 'assign_program', {"program_id":"30517","group_names":["Bootcamp"],"start_date":"2026-10-19","start_day":1});
CLI
cotlet call truecoach assign_program --data '{"program_id":"30517","group_names":["Bootcamp"],"start_date":"2026-10-19","start_day":1}'

Example response

{
  "program_id": "30517",
  "assigned_clients": 6,
  "start_date": "2026-10-19",
  "start_day": 1
}

Unassign program

write

POST https://cotlet.dev/api/v1/truecoach/unassign_program

Removes the upcoming workouts of the program from the client calendar. It reaches no one and a new assign_program restores it, so it does not ask for your OK.

Parameters

Parameters: unassign_program
NameTypeDescription
program_id required string Program ID from list_programs.
client_id required string Client ID from list_clients.

Request

cURL
curl -X POST https://cotlet.dev/api/v1/truecoach/unassign_program \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"program_id":"program_8c41d2","client_id":"client_8c41d2"}'
Python
result = client.call("truecoach", "unassign_program", {"program_id":"program_8c41d2","client_id":"client_8c41d2"})
Node.js
const result = await cotlet.call('truecoach', 'unassign_program', {"program_id":"program_8c41d2","client_id":"client_8c41d2"});
CLI
cotlet call truecoach unassign_program --data '{"program_id":"program_8c41d2","client_id":"client_8c41d2"}'

Example response

{
  "program_id": "30517",
  "client_id": "4821907",
  "unassigned": true
}

Add client to group

write

POST https://cotlet.dev/api/v1/truecoach/add_client_to_group

Adds the group to the client and keeps their other groups. The group must exist in Manage Groups. It reaches no one, and removing the client from the group in TrueCoach undoes it, so it does not ask for your OK.

Parameters

Parameters: add_client_to_group
NameTypeDescription
client_id required string Client ID from list_clients.
group_name required string Client group name.

Request

cURL
curl -X POST https://cotlet.dev/api/v1/truecoach/add_client_to_group \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"client_id":"client_8c41d2","group_name":"group name"}'
Python
result = client.call("truecoach", "add_client_to_group", {"client_id":"client_8c41d2","group_name":"group name"})
Node.js
const result = await cotlet.call('truecoach', 'add_client_to_group', {"client_id":"client_8c41d2","group_name":"group name"});
CLI
cotlet call truecoach add_client_to_group --data '{"client_id":"client_8c41d2","group_name":"group name"}'

Example response

{
  "client_id": "4822040",
  "groups": [
    "January"
  ]
}

Update metric

write

POST https://cotlet.dev/api/v1/truecoach/update_metric

Updates the metric as a coach would in the Metric Manager on the client calendar. The metric must already be assigned to the client. It does not ask for your OK; clients can see their own metrics.

Parameters

Parameters: update_metric
NameTypeDescription
client_id required string Client ID from list_clients.
metric required string Metric name from list_metrics.
value required string New value, in the metric's unit.
date date Date of the measurement. Default: today.

Request

cURL
curl -X POST https://cotlet.dev/api/v1/truecoach/update_metric \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"client_id":"client_8c41d2","metric":"metric","value":"value"}'
Python
result = client.call("truecoach", "update_metric", {"client_id":"client_8c41d2","metric":"metric","value":"value"})
Node.js
const result = await cotlet.call('truecoach', 'update_metric', {"client_id":"client_8c41d2","metric":"metric","value":"value"});
CLI
cotlet call truecoach update_metric --data '{"client_id":"client_8c41d2","metric":"metric","value":"value"}'

Example response

{
  "client_id": "4821907",
  "metric": "Back Squat",
  "value": "112.5",
  "date": "2026-10-11"
}

Send message

write Confirm

POST https://cotlet.dev/api/v1/truecoach/send_message

A message to a group reaches each client individually, as in TrueCoach. Clients who are not logged in to TrueCoach get the message text by email. By default you confirm each call; you can switch that off for this tool.

Parameters

Parameters: send_message
NameTypeDescription
client_id string One client. Give this or group_name.
group_name string Each client in the group gets the message individually.
body required string Message text.

Request

cURL
curl -X POST https://cotlet.dev/api/v1/truecoach/send_message \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"client_id":"4821907","body":"Hi Sam, Tuesday'\''s lower body and Thursday'\''s intervals slipped this week. Busy stretch or something else? Tell me and I'\''ll adjust next week."}'
Python
result = client.call("truecoach", "send_message", {"client_id":"4821907","body":"Hi Sam, Tuesday's lower body and Thursday's intervals slipped this week. Busy stretch or something else? Tell me and I'll adjust next week."})
Node.js
const result = await cotlet.call('truecoach', 'send_message', {"client_id":"4821907","body":"Hi Sam, Tuesday's lower body and Thursday's intervals slipped this week. Busy stretch or something else? Tell me and I'll adjust next week."});
CLI
cotlet call truecoach send_message --data '{"client_id":"4821907","body":"Hi Sam, Tuesday'\''s lower body and Thursday'\''s intervals slipped this week. Busy stretch or something else? Tell me and I'\''ll adjust next week."}'

Example response

{
  "sent": 1,
  "client_id": "4821907",
  "sent_at": "2026-10-11T09:30:00+02:00"
}