Create a workout v2 plan moment

cURL

curl -X POST "https://api.fitsociety.io/public/v1/workout/plans/moments/{planId}" \
  -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({
    name: [{lang: 'en', value: 'Benchmark: Helen'}],
    description: [
      {
        lang: 'en',
        value: '3 rounds for time: 400m run, 21 kettlebell swings (24/16 kg), 12 pull-ups.'
      }
    ]
  })
};

fetch('https://api.fitsociety.io/public/v1/workout/plans/moments/{planId}', 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/moments/{planId}"

payload = {
    "name": [
        {
            "lang": "en",
            "value": "Benchmark: Helen"
        }
    ],
    "description": [
        {
            "lang": "en",
            "value": "3 rounds for time: 400m run, 21 kettlebell swings (24/16 kg), 12 pull-ups."
        }
    ]
}
headers = {
    "Idempotency-Key": "<idempotency-key>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

{
  "data": {
    "planMoment": {
      "_id": "67f1234567890abcdef1234",
      "name": [
        {
          "lang": "en",
          "value": "Full Body Strength"
        },
        {
          "lang": "nl",
          "value": "Full Body Kracht"
        }
      ],
      "description": [
        {
          "lang": "en",
          "value": "Full Body Strength"
        },
        {
          "lang": "nl",
          "value": "Full Body Kracht"
        }
      ],
      "dayOrder": 1,
      "order": 0,
      "weekNumber": 1,
      "sessionOrder": 1,
      "date": "2026-04-15",
      "scoringType": "forTime",
      "targetValue": null,
      "descriptionOnly": true,
      "timeDomain": {
        "windowSeconds": null,
        "timeCapSeconds": 900,
        "rounds": 3,
        "intervalSeconds": null,
        "intervalCount": null,
        "workSeconds": null,
        "restSeconds": null
      },
      "scoreValidation": {
        "timeCapSeconds": 900,
        "maxReps": null,
        "expectedIntervals": null
      },
      "exercises": [
        {
          "_id": "67f1234567890abcdef1234",
          "exerciseId": "67f1234567890abcdef1234",
          "type": "reps",
          "minReps": 6,
          "maxReps": 8,
          "notes": "Pause 1 second on the chest.",
          "sets": 4,
          "metric": "kg",
          "rest": 120,
          "intensity": "High",
          "difficulty": "Intermediate",
          "groupId": "super-a",
          "rpe": 8,
          "rmPercentage": 75,
          "tempo": "3010",
          "perSetTrackingEnabled": true,
          "rpeEnabled": false,
          "showSetRpe": true,
          "setsData": [
            {
              "setNumber": 1,
              "setType": "N",
              "metric": "12",
              "repetition": "8-12",
              "weight": 60,
              "rest": 90,
              "rpe": 7.5,
              "duration": 45,
              "distance": 250
            }
          ],
          "setupSettingsEnabled": true,
          "setupFields": [
            {
              "key": "seat",
              "label": "Seat",
              "type": "text",
              "unit": "",
              "options": [
                "1",
                "2",
                "3",
                "4"
              ],
              "order": 1,
              "required": false,
              "enabled": true,
              "defaultValue": 3
            }
          ],
          "order": 0,
          "isDeleted": false,
          "deletedAt": null,
          "createdAt": "2026-04-12T10:00:00.000Z",
          "updatedAt": "2026-04-12T10:00:00.000Z"
        }
      ],
      "isDeleted": false,
      "deletedAt": null,
      "createdAt": "2026-04-12T10:00:00.000Z",
      "updatedAt": "2026-04-12T10:00:00.000Z"
    }
  },
  "meta": {
    "requestId": "4f849d7d-f4f1-45cc-b4b7-3984a3d17f83",
    "rateLimit": {
      "limit": 10,
      "remaining": 9,
      "resetSeconds": 1
    },
    "idempotency": {
      "replayed": false
    }
  }
}

POST

public

workout

plans

moments

{planId}

cURL

curl -X POST "https://api.fitsociety.io/public/v1/workout/plans/moments/{planId}" \
  -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({
    name: [{lang: 'en', value: 'Benchmark: Helen'}],
    description: [
      {
        lang: 'en',
        value: '3 rounds for time: 400m run, 21 kettlebell swings (24/16 kg), 12 pull-ups.'
      }
    ]
  })
};

fetch('https://api.fitsociety.io/public/v1/workout/plans/moments/{planId}', 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/moments/{planId}"

payload = {
    "name": [
        {
            "lang": "en",
            "value": "Benchmark: Helen"
        }
    ],
    "description": [
        {
            "lang": "en",
            "value": "3 rounds for time: 400m run, 21 kettlebell swings (24/16 kg), 12 pull-ups."
        }
    ]
}
headers = {
    "Idempotency-Key": "<idempotency-key>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

{
  "data": {
    "planMoment": {
      "_id": "67f1234567890abcdef1234",
      "name": [
        {
          "lang": "en",
          "value": "Full Body Strength"
        },
        {
          "lang": "nl",
          "value": "Full Body Kracht"
        }
      ],
      "description": [
        {
          "lang": "en",
          "value": "Full Body Strength"
        },
        {
          "lang": "nl",
          "value": "Full Body Kracht"
        }
      ],
      "dayOrder": 1,
      "order": 0,
      "weekNumber": 1,
      "sessionOrder": 1,
      "date": "2026-04-15",
      "scoringType": "forTime",
      "targetValue": null,
      "descriptionOnly": true,
      "timeDomain": {
        "windowSeconds": null,
        "timeCapSeconds": 900,
        "rounds": 3,
        "intervalSeconds": null,
        "intervalCount": null,
        "workSeconds": null,
        "restSeconds": null
      },
      "scoreValidation": {
        "timeCapSeconds": 900,
        "maxReps": null,
        "expectedIntervals": null
      },
      "exercises": [
        {
          "_id": "67f1234567890abcdef1234",
          "exerciseId": "67f1234567890abcdef1234",
          "type": "reps",
          "minReps": 6,
          "maxReps": 8,
          "notes": "Pause 1 second on the chest.",
          "sets": 4,
          "metric": "kg",
          "rest": 120,
          "intensity": "High",
          "difficulty": "Intermediate",
          "groupId": "super-a",
          "rpe": 8,
          "rmPercentage": 75,
          "tempo": "3010",
          "perSetTrackingEnabled": true,
          "rpeEnabled": false,
          "showSetRpe": true,
          "setsData": [
            {
              "setNumber": 1,
              "setType": "N",
              "metric": "12",
              "repetition": "8-12",
              "weight": 60,
              "rest": 90,
              "rpe": 7.5,
              "duration": 45,
              "distance": 250
            }
          ],
          "setupSettingsEnabled": true,
          "setupFields": [
            {
              "key": "seat",
              "label": "Seat",
              "type": "text",
              "unit": "",
              "options": [
                "1",
                "2",
                "3",
                "4"
              ],
              "order": 1,
              "required": false,
              "enabled": true,
              "defaultValue": 3
            }
          ],
          "order": 0,
          "isDeleted": false,
          "deletedAt": null,
          "createdAt": "2026-04-12T10:00:00.000Z",
          "updatedAt": "2026-04-12T10:00:00.000Z"
        }
      ],
      "isDeleted": false,
      "deletedAt": null,
      "createdAt": "2026-04-12T10:00:00.000Z",
      "updatedAt": "2026-04-12T10:00:00.000Z"
    }
  },
  "meta": {
    "requestId": "4f849d7d-f4f1-45cc-b4b7-3984a3d17f83",
    "rateLimit": {
      "limit": 10,
      "remaining": 9,
      "resetSeconds": 1
    },
    "idempotency": {
      "replayed": false
    }
  }
}

Authorizations

Authorization

string

header

required

Public API access token issued by /public/v1/oauth/token. Example: Authorization: Bearer fspt_.... Each resource request rechecks the token company's current provider access. Disabling access blocks existing tokens with 403 auth.provider_unavailable.

Headers

Idempotency-Key

string

required

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.

Required string length: 1 - 200

Example:

"booking-create-20260714-001"

Path Parameters

planId

string

required

Workout plan id.

Example:

"67f1234567890abcdef1234"

Body

application/json

name

object[]

required

Minimum array length: 1

Show child attributes

Example:

[
  {
    "lang": "en",
    "value": "Full Body Strength"
  },
  { "lang": "nl", "value": "Full Body Kracht" }
]

description

object[]

required

Minimum array length: 1

Show child attributes

Example:

[
  {
    "lang": "en",
    "value": "Full Body Strength"
  },
  { "lang": "nl", "value": "Full Body Kracht" }
]

scoringType

enum<string>

default:standard

Scoring mechanism. Must not be standard when descriptionOnly is true.

Available options:

standard,

forTime,

amrap,

emom,

tabata,

maxLoad

Example:

"forTime"

targetValue

number | null

Required range: x >= 0

Example:

null

descriptionOnly

boolean

default:false

Marks an exercise-free scored day: the full workout lives in description (required), exercises must stay empty, scoringType must not be standard, and amrap/emom/tabata require their full timeDomain. Completing the day requires a manual wodResult. Enforced on every write path, including client day edits. Moments that merely have no exercises are NOT scored unless this is true.

Example:

true

timeDomain

object | null

Clock prescription, same contract as a WOD timeDomain. Allowed fields depend on scoringType: amrap → windowSeconds (required); forTime → timeCapSeconds, rounds (defaults to 1); emom → intervalSeconds, intervalCount (both required); tabata → workSeconds, restSeconds, intervalCount (all required); standard/maxLoad → none.

Show child attributes

scoreValidation

object | null

Optional result caps. timeCapSeconds and expectedIntervals are derived from timeDomain when one is set.

Show child attributes

dayOrder

number

Example:

1

order

number

Example:

0

weekNumber

integer

Programme week. Omitted legacy moments are week 1.

Required range: x >= 1

Example:

1

sessionOrder

integer

Session position within the programme week.

Required range: x >= 1

Example:

1

date

string

Example:

"2026-04-15"

exercises

object[]

Show child attributes

schedulePlacement

object

Show child attributes

Response

Created plan moment.

data

object

required

Show child attributes

Workout V2

Health

OAuth

Platform

Company catalog

Clients

Calendar and bookings

Finance

Credits

Progress

Habits

Forms

Documents

Reports

Conversations

Exports

Webhooks

Authorizations

Headers

Path Parameters

Body

Response