curl -X POST "https://api.fitsociety.io/public/v1/workout/groups/runs/{runId}/participants" \
-H "Authorization: Bearer <access_token>" \
-H "Idempotency-Key: <stable_request_key>" \
-H "Content-Type: application/json" \
-d '{}'const options = {
method: 'POST',
headers: {
'Idempotency-Key': '<idempotency-key>',
Authorization: 'Bearer <token>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
participants: [
{
clientId: '67f1234567890abcdef1234',
workoutSource: 'auto_assigned_plan',
planId: null,
planMomentId: null,
resumeAction: 'continue',
confirmationToken: 'a0eb661b-bf61-4af6-98f0-d7d7ff8a3e75'
}
]
})
};
fetch('https://api.fitsociety.io/public/v1/workout/groups/runs/{runId}/participants', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.fitsociety.io/public/v1/workout/groups/runs/{runId}/participants"
payload = { "participants": [
{
"clientId": "67f1234567890abcdef1234",
"workoutSource": "auto_assigned_plan",
"planId": None,
"planMomentId": None,
"resumeAction": "continue",
"confirmationToken": "a0eb661b-bf61-4af6-98f0-d7d7ff8a3e75"
}
] }
headers = {
"Idempotency-Key": "<idempotency-key>",
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"data": {
"run": {
"runId": "67f1234567890abcdef1234",
"source": "calendar_event",
"status": "active",
"calendarEventId": null,
"manualSessionKey": "small-group-2026-06-04-09",
"startedAt": null,
"endedAt": null
},
"results": [
{
"clientId": "67f1234567890abcdef1234",
"ok": true,
"sessionId": null,
"sessionStatus": "planned",
"workoutSource": "auto_assigned_plan",
"sourceLabel": "Full Body - Day 2",
"templateId": null,
"errorCode": "",
"requiresConfirmation": false,
"confirmationToken": null,
"confirmationTokenExpiresAt": null,
"timerStartedAt": null,
"timerPausedAt": null,
"timerElapsedMs": 90000,
"runTimer": {
"timerStartedAt": null,
"timerPausedAt": null,
"timerElapsedMs": 300000
}
}
],
"counts": {
"total": 2,
"started": 1,
"pendingConfirmation": 1,
"failed": 0
}
},
"meta": {
"requestId": "4f849d7d-f4f1-45cc-b4b7-3984a3d17f83",
"rateLimit": {
"limit": 10,
"remaining": 9,
"resetSeconds": 1
},
"idempotency": {
"replayed": false
}
}
}Add participants to an active group workout run
Adds new participants and re-adds participants whose previous run entry is terminal, such as cancelled, stopped, completed, or error. A member whose workout resolution or session start fails remains in the run as a retryable error participant, with the failure code in the result. Participants already pending, in progress, or paused are left unchanged. Booked participants are authorized within their lesson and session regardless of home location; the coach must have access to the lesson location. Unbooked additions and manual workouts retain normal member access.
Requires the workout_groups:write scope and the corresponding Workout features and permissions.
curl -X POST "https://api.fitsociety.io/public/v1/workout/groups/runs/{runId}/participants" \
-H "Authorization: Bearer <access_token>" \
-H "Idempotency-Key: <stable_request_key>" \
-H "Content-Type: application/json" \
-d '{}'const options = {
method: 'POST',
headers: {
'Idempotency-Key': '<idempotency-key>',
Authorization: 'Bearer <token>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
participants: [
{
clientId: '67f1234567890abcdef1234',
workoutSource: 'auto_assigned_plan',
planId: null,
planMomentId: null,
resumeAction: 'continue',
confirmationToken: 'a0eb661b-bf61-4af6-98f0-d7d7ff8a3e75'
}
]
})
};
fetch('https://api.fitsociety.io/public/v1/workout/groups/runs/{runId}/participants', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.fitsociety.io/public/v1/workout/groups/runs/{runId}/participants"
payload = { "participants": [
{
"clientId": "67f1234567890abcdef1234",
"workoutSource": "auto_assigned_plan",
"planId": None,
"planMomentId": None,
"resumeAction": "continue",
"confirmationToken": "a0eb661b-bf61-4af6-98f0-d7d7ff8a3e75"
}
] }
headers = {
"Idempotency-Key": "<idempotency-key>",
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"data": {
"run": {
"runId": "67f1234567890abcdef1234",
"source": "calendar_event",
"status": "active",
"calendarEventId": null,
"manualSessionKey": "small-group-2026-06-04-09",
"startedAt": null,
"endedAt": null
},
"results": [
{
"clientId": "67f1234567890abcdef1234",
"ok": true,
"sessionId": null,
"sessionStatus": "planned",
"workoutSource": "auto_assigned_plan",
"sourceLabel": "Full Body - Day 2",
"templateId": null,
"errorCode": "",
"requiresConfirmation": false,
"confirmationToken": null,
"confirmationTokenExpiresAt": null,
"timerStartedAt": null,
"timerPausedAt": null,
"timerElapsedMs": 90000,
"runTimer": {
"timerStartedAt": null,
"timerPausedAt": null,
"timerElapsedMs": 300000
}
}
],
"counts": {
"total": 2,
"started": 1,
"pendingConfirmation": 1,
"failed": 0
}
},
"meta": {
"requestId": "4f849d7d-f4f1-45cc-b4b7-3984a3d17f83",
"rateLimit": {
"limit": 10,
"remaining": 9,
"resetSeconds": 1
},
"idempotency": {
"replayed": false
}
}
}Authorizations
Headers
Required for Public API write requests. Reusing the same key with the same method, path, and body replays the stored successful response; reusing it with a different request returns 409 idempotency.conflict.
1 - 200"booking-create-20260714-001"