curl -X POST 'https://api.fitsociety.io/public/v1/workout/plans/create-and-assign/66f7b8b1e13c8d25f4d3d90c' \
-H 'Authorization: Bearer <access_token>' \
-H 'Idempotency-Key: public-v1-workout-plans-create-and-assign-clientId-001' \
-H 'Content-Type: application/json' \
-d '{"name":[{"lang":"en","value":"Strength programme"}],"description":[{"lang":"en","value":"Progressive strength training."}],"category":"Strength","visibility":"Company","schedule":{"mode":"recurring","releasePolicy":"all_at_once","startDate":""},"useDefaultExerciseSettings":true,"defaultExerciseValues":{"sets":3,"reps":"8-12","rest":90,"weight":0,"repTempo":"3010","duration":0}}'const options = {
method: 'POST',
headers: {
'Idempotency-Key': '<idempotency-key>',
Authorization: 'Bearer <token>',
'Content-Type': 'application/json'
},
body: JSON.stringify({name: [{lang: 'en', value: 'Strength programme'}], visibility: 'Company'})
};
fetch('https://api.fitsociety.io/public/v1/workout/plans/create-and-assign/{clientId}', 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/plans/create-and-assign/{clientId}"
payload = {
"name": [
{
"lang": "en",
"value": "Strength programme"
}
],
"visibility": "Company"
}
headers = {
"Idempotency-Key": "<idempotency-key>",
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"data": {
"planId": "67f1234567890abcdef1234",
"clientId": "67f1234567890abcdef1234",
"templateType": "Assigned",
"status": "Active",
"externalReference": {
"externalId": "66f7b8b1e13c8d25f4d3d90a",
"revision": 1
}
},
"meta": {
"requestId": "4f849d7d-f4f1-45cc-b4b7-3984a3d17f83",
"rateLimit": {
"limit": 10,
"remaining": 9,
"resetSeconds": 1
},
"idempotency": {
"replayed": false
}
}
}Create a workout plan assigned to one client
Creates an assigned plan directly for the target client without a library template. The server sets templateType=Assigned, clientId from the path and sourceTemplateId=null. Accepts application/json or multipart/form-data; send structured multipart fields as JSON strings. Description is optional. Large videos can be uploaded directly to storage through the plan video-uploads presign flow and referenced as a videos entry, as on POST /public/v1/workout/plans. Supply visibility and either valid defaultExerciseValues or useDefaultExerciseSettings=false. The response planId is used to add days with POST /public/v1/workout/plans/moments/, then add exercises with POST /public/v1/workout/plans/moments/exercises//. Per-set prescriptions, rest and tempo belong to those exercise requests; supersets use the separate plan-moment superset operations. This request does not create nested workout days or exercises. Coaches must supply scheduleStartDate or schedule.startDate for multi_week or calendar_week schedules. A recurring calendar_week start must be a company-local Monday. Create workout days first, then reference their returned IDs with PUT /public/v1/workout/plans//calendar-schedule. Calendar-week definitions cannot reference days that do not yet exist. Programme calendar features remain gated by company settings.
Requires the workout_plans:write scope and the corresponding Workout features and permissions.
The clientId path parameter identifies a client in the company bound to the Public API token.
curl -X POST 'https://api.fitsociety.io/public/v1/workout/plans/create-and-assign/66f7b8b1e13c8d25f4d3d90c' \
-H 'Authorization: Bearer <access_token>' \
-H 'Idempotency-Key: public-v1-workout-plans-create-and-assign-clientId-001' \
-H 'Content-Type: application/json' \
-d '{"name":[{"lang":"en","value":"Strength programme"}],"description":[{"lang":"en","value":"Progressive strength training."}],"category":"Strength","visibility":"Company","schedule":{"mode":"recurring","releasePolicy":"all_at_once","startDate":""},"useDefaultExerciseSettings":true,"defaultExerciseValues":{"sets":3,"reps":"8-12","rest":90,"weight":0,"repTempo":"3010","duration":0}}'const options = {
method: 'POST',
headers: {
'Idempotency-Key': '<idempotency-key>',
Authorization: 'Bearer <token>',
'Content-Type': 'application/json'
},
body: JSON.stringify({name: [{lang: 'en', value: 'Strength programme'}], visibility: 'Company'})
};
fetch('https://api.fitsociety.io/public/v1/workout/plans/create-and-assign/{clientId}', 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/plans/create-and-assign/{clientId}"
payload = {
"name": [
{
"lang": "en",
"value": "Strength programme"
}
],
"visibility": "Company"
}
headers = {
"Idempotency-Key": "<idempotency-key>",
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"data": {
"planId": "67f1234567890abcdef1234",
"clientId": "67f1234567890abcdef1234",
"templateType": "Assigned",
"status": "Active",
"externalReference": {
"externalId": "66f7b8b1e13c8d25f4d3d90a",
"revision": 1
}
},
"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"
Path Parameters
Body
Plan metadata and exercise defaults. Description is optional. Supply defaultExerciseValues unless useDefaultExerciseSettings is false; when disabled, omit the defaults or send null. Create workout days and their exercises through the separate moment/exercise endpoints after receiving planId.
Coach-managed client visibility for ordinary training plans, separate from library sharing. Missing values remain visible. False keeps the plan and linked session details in the coaching environment only; clients cannot change this field. WOD and multiweek plans are unaffected and ignore writes to this field.
Agility & Speed, Strength, Hypertrophy, Strength - Dynamic, Strength - Explosive, Strength - Static, Cardio, Cardio - Duration, Cardio - Interval, HIIT, Crossfit, Mobility, Stretching, Core, Coordination & Balance, Movement Prep, Functional Training, Recovery, Sports, Martial Arts, Yoga, Other, GROUP_WORKOUT_TEMPLATE, Plyometric, Cycling, Cardio - interval, Mobilisation, Stabilisation, Daily Living, Target zone, Respiration, Breathing, Massage, Outdoor sports, Indoor sports, Dance, Group Lessons, Martial arts, Material Arts, Fight skills, Mind and body, , default "Strength"
Optional opaque resource reference owned by the authenticated API client and company. Available only for application/json creation without file uploads. Trimmed, nonempty and at most 200 characters; control characters are rejected. Repeating the reference with the same creation content returns the existing resource; conflicting content returns 409.
1 - 200^[^\u0000-\u001F\u007F]+$"programme-v1"