cURL

curl -X POST 'https://api.fitsociety.io/public/v1/workout/exercises' \
  -H 'Authorization: Bearer <access_token>' \
  -H 'Idempotency-Key: public-v1-workout-exercises-001' \
  -H 'Content-Type: application/json' \
  -d '{"name":[{"lang":"en","value":"Barbell Bench Press"}],"description":[{"lang":"en","value":"Flat horizontal press."}],"primaryCategory":"Strength","primaryMuscle":"Chest","visibility":"Company"}'

const options = {
  method: 'POST',
  headers: {
    'Idempotency-Key': '<idempotency-key>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    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'}
    ],
    primaryCategory: 'Strength',
    primaryMuscle: 'Chest'
  })
};

fetch('https://api.fitsociety.io/public/v1/workout/exercises', 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/exercises"

payload = {
    "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"
        }
    ],
    "primaryCategory": "Strength",
    "primaryMuscle": "Chest"
}
headers = {
    "Idempotency-Key": "<idempotency-key>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

{
  "data": {
    "_id": "67f1234567890abcdef1234",
    "exerciseId": "67f1234567890abcdef1234",
    "exercise": {
      "name": "Barbell Bench Press",
      "description": "Flat horizontal press.",
      "primaryCategory": "Strength",
      "secondaryCategories": [
        "Agility & Speed"
      ],
      "primaryMuscle": "Chest",
      "secondaryMuscles": [
        "Chest"
      ],
      "primaryJoint": "Shoulder",
      "equipment": [
        "Dumbbells"
      ],
      "popularity": 82,
      "difficulty": "Intermediate",
      "intensity": "Above Average",
      "visibility": "Everyone",
      "createdAt": "2026-04-12T10:00:00.000Z",
      "images": [
        {
          "url": "https://cdn.example.com/workouts/plan-cover.jpg",
          "width": 1280,
          "height": 720
        }
      ],
      "videos": [
        {
          "url": "https://cdn.example.com/workouts/demo.mp4",
          "platform": "s3",
          "videoId": "",
          "thumbnail": "https://cdn.example.com/workouts/demo-thumb.jpg",
          "duration": 84,
          "width": 1920,
          "height": 1080
        }
      ],
      "muscleActivation": {
        "raw": {
          "chest": 18,
          "shoulders": 12,
          "triceps": 8
        },
        "normalized": {
          "chest": 18,
          "shoulders": 12,
          "triceps": 8
        },
        "maxValue": 18,
        "topMuscles": [
          {
            "muscle": "chest",
            "value": 18
          }
        ]
      }
    },
    "externalReference": {
      "externalId": "66f7b8b1e13c8d25f4d3d90a",
      "revision": 1
    }
  },
  "meta": {
    "requestId": "4f849d7d-f4f1-45cc-b4b7-3984a3d17f83",
    "rateLimit": {
      "limit": 10,
      "remaining": 9,
      "resetSeconds": 1
    },
    "idempotency": {
      "replayed": false
    }
  }
}

Exercises

Create a workout exercise

Videos share the company video-library storage allowance (25 decimal GB by default, admin adjustable). Coach web clients should use the exercise video-uploads presign/complete/status flow and send ready video URLs. Existing native multipart video uploads remain supported up to 100 MiB per file; these reserve the same quota and wait for the same compression worker. Creates a new exercise in the authenticated company scope. Accepts either application/json or multipart/form-data. In multipart requests, send structured arrays and objects as JSON strings, use imageFiles and videoFiles for uploads, and note that the legacy binary aliases images and videos are still accepted by the backend. Client-created exercises are forced to visibility=Company by the controller.

Requires the workout_library:write scope and the corresponding Workout features and permissions.

POST

public

workout

exercises

cURL

curl -X POST 'https://api.fitsociety.io/public/v1/workout/exercises' \
  -H 'Authorization: Bearer <access_token>' \
  -H 'Idempotency-Key: public-v1-workout-exercises-001' \
  -H 'Content-Type: application/json' \
  -d '{"name":[{"lang":"en","value":"Barbell Bench Press"}],"description":[{"lang":"en","value":"Flat horizontal press."}],"primaryCategory":"Strength","primaryMuscle":"Chest","visibility":"Company"}'

const options = {
  method: 'POST',
  headers: {
    'Idempotency-Key': '<idempotency-key>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    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'}
    ],
    primaryCategory: 'Strength',
    primaryMuscle: 'Chest'
  })
};

fetch('https://api.fitsociety.io/public/v1/workout/exercises', 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/exercises"

payload = {
    "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"
        }
    ],
    "primaryCategory": "Strength",
    "primaryMuscle": "Chest"
}
headers = {
    "Idempotency-Key": "<idempotency-key>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

{
  "data": {
    "_id": "67f1234567890abcdef1234",
    "exerciseId": "67f1234567890abcdef1234",
    "exercise": {
      "name": "Barbell Bench Press",
      "description": "Flat horizontal press.",
      "primaryCategory": "Strength",
      "secondaryCategories": [
        "Agility & Speed"
      ],
      "primaryMuscle": "Chest",
      "secondaryMuscles": [
        "Chest"
      ],
      "primaryJoint": "Shoulder",
      "equipment": [
        "Dumbbells"
      ],
      "popularity": 82,
      "difficulty": "Intermediate",
      "intensity": "Above Average",
      "visibility": "Everyone",
      "createdAt": "2026-04-12T10:00:00.000Z",
      "images": [
        {
          "url": "https://cdn.example.com/workouts/plan-cover.jpg",
          "width": 1280,
          "height": 720
        }
      ],
      "videos": [
        {
          "url": "https://cdn.example.com/workouts/demo.mp4",
          "platform": "s3",
          "videoId": "",
          "thumbnail": "https://cdn.example.com/workouts/demo-thumb.jpg",
          "duration": 84,
          "width": 1920,
          "height": 1080
        }
      ],
      "muscleActivation": {
        "raw": {
          "chest": 18,
          "shoulders": 12,
          "triceps": 8
        },
        "normalized": {
          "chest": 18,
          "shoulders": 12,
          "triceps": 8
        },
        "maxValue": 18,
        "topMuscles": [
          {
            "muscle": "chest",
            "value": 18
          }
        ]
      }
    },
    "externalReference": {
      "externalId": "66f7b8b1e13c8d25f4d3d90a",
      "revision": 1
    }
  },
  "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"

Body

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" }
]

primaryCategory

enum<string>

required

Available options:

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

Example:

"Strength"

primaryMuscle

enum<string>

required

Available options:

Chest,

Back,

Lats,

Traps,

Shoulders,

Biceps,

Triceps,

Forearms,

Core,

Abs,

Obliques,

Glutes,

Quads,

Hamstrings,

Calves,

Adductors,

Abductors,

Hip Flexors,

Full Body,

Cardio / Conditioning,

Neck,

Lower Back

Example:

"Chest"

secondaryCategories

enum<string>[]

Available options:

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

Example:

["General Fitness"]

secondaryMuscles

enum<string>[]

Available options:

Chest,

Back,

Lats,

Traps,

Shoulders,

Biceps,

Triceps,

Forearms,

Core,

Abs,

Obliques,

Glutes,

Quads,

Hamstrings,

Calves,

Adductors,

Abductors,

Hip Flexors,

Full Body,

Cardio / Conditioning,

Neck,

Lower Back

Example:

["Shoulders", "Triceps"]

primaryJoint

enum<string>

Available options:

Ankle,

Combination,

Core,

Elbow,

Fingers,

Hip,

Knee,

Neck,

Shoulder,

Spine,

Wrist

Example:

"Shoulder"

equipment

enum<string>[]

Available options:

Dumbbells,

AdjustableDumbbells,

Kettlebell,

AdjustableKettlebell,

CompetitionKettlebell,

Medicineball,

SlamBall,

WallBall,

Weightplate,

BumperPlates,

FractionalPlates,

LoadableDumbbellHandle,

Sandbag,

StrongmanSandbag,

Bulgarianbag,

Aquabag,

Aquaball,

Hydrovest,

MagneticBell,

Macebell,

SteelClub,

IndianClub,

Barbell,

OlympicBarbell,

TechniqueBar,

EZBar,

TrapBar,

SafetySquatBar,

SwissBar,

CamberedBar,

AxleBar,

Landmine,

Bench,

FlatBench,

AdjustableBench,

InclineBench,

DeclineBench,

SealRowBench,

HipThrustBench,

BenchPressRack,

SquatRack,

SquatStand,

PowerRack,

WallMountedRack,

HalfRack,

SmithMachine,

Monolift,

JammerArms,

BarbellJack,

WeightTree,

PlateStorage,

DeadliftPlatform,

Rig,

StrengthMachinesPlateloaded,

StrengthMachinesWeightstack,

StrengthMachinesPneumatic,

MultiGym,

LegPressMachine,

VerticalLegPressMachine,

LeverageSquatMachine,

LinearHackSquatMachine,

BeltSquatMachine,

PendulumSquatMachine,

VSquatMachine,

HackSquatMachine,

LegExtensionMachine,

LegCurlMachine,

SeatedLegCurlMachine,

LyingLegCurlMachine,

StandingLegCurlMachine,

StandingCalfRaiseMachine,

SeatedCalfRaiseMachine,

CalfPressMachine,

HipThrustMachine,

GluteDriveMachine,

GluteKickbackMachine,

HipExtensionMachine,

HipAbductionMachine,

HipAdductionMachine,

ChestPressMachine,

VerticalChestPressMachine,

InclineChestPressMachine,

DeclineChestPressMachine,

IsoLateralChestPressMachine,

IsoLateralInclinePressMachine,

ShoulderPressMachine,

IsoLateralShoulderPressMachine,

MultiPressMachine,

LateralRaiseMachine,

RearDeltMachine,

PecDeckMachine,

PulloverMachine,

LatPulldownMachine,

IsoLateralLatPulldownMachine,

AssistedPullupMachine,

AssistedDipMachine,

SeatedDipMachine,

SeatedRowMachine,

LowRowMachine,

HighRowMachine,

IsoLateralRowMachine,

ChestSupportedRowMachine,

TBarRowMachine,

BicepsCurlMachine,

PreacherCurlMachine,

TricepsExtensionMachine,

AbCrunchMachine,

AbCoasterMachine,

RotaryTorsoMachine,

BackExtensionMachine,

SeatedBackExtensionMachine,

HyperextensionBench,

ReverseHyper,

GHD,

Kinesis,

Pulley,

CableMachine,

CableStation,

CableColumn,

CableCrossover,

DualAdjustablePulley,

SingleCableTower,

FunctionalTrainer,

TotalGymGTS,

Gymstick,

ViPR,

RipTrainer,

Battlerope,

ProwlerSled,

FarmersHandles,

Yoke,

Tire,

Sledgehammer,

TorqueTank,

SledTrack,

WallBallTarget,

AgilityPoles,

MiniHurdles,

SprintParachute,

PullUpBar,

Parallelbars,

DipBars,

Equalizer,

Suspensiontrainer,

SuspensionSlingTrainer,

GymnasticRings,

MonkeyBars,

PegBoard,

RopeClimb,

Wall,

StallBars,

DoorPullUpBar,

PushUpHandles,

AbStraps,

Boxstep,

SoftPlyoBox,

Hurdle,

Speedladder,

Parallettes,

NordicBench,

SissySquatBench,

Cardio,

Treadmill,

CurvedTreadmill,

AirRunner,

AssaultRunner,

StationaryBike,

UprightBike,

RecumbentBike,

BikeErg,

SpinBike,

AirBike,

Rower,

WaterRower,

FanRower,

ArmErgometer,

SkiErg,

Elliptical,

ArcTrainer,

NuStep,

StairClimber,

StepMill,

JacobsLadder,

VersaClimber,

Bosu,

Balanceball,

Exerciseball,

PilatesTennisball,

PilatesRing,

YogaMat,

YogaBlock,

YogaWheel,

StretchStrap,

MobilityStick,

MassageBall,

PeanutMassageBall,

Airpad,

Balanceboard,

BalancePad,

WobbleBoard,

Glidedisc,

Foamroller,

Elasticbands,

TherapyBand,

Resistanceband,

MiniBand,

PullUpAssistBand,

Powertube,

AnkleWeights,

SlantBoard,

Vibrationtraining,

CableRope,

StraightBarAttachment,

CurlBarAttachment,

LatBarAttachment,

TricepsBarAttachment,

RowHandle,

DHandle,

DoubleDHandle,

AnkleCuff,

CableCuff,

LandmineHandle,

MagGripAttachment,

DipBelt,

AbWheel,

WristRoller,

FatGrip,

Chain,

DoorAnchor,

JumpRope,

SpeedRope,

WeightedJumpRope,

SledHarness,

LiftingStraps,

LiftingHooks,

WristWraps,

WeightliftingBelt,

Clubbel,

Stick,

Bodybow,

BuddySystem,

Multinet,

Flowin,

Aerialhoop,

Dancingpole,

Trapeze,

HulaHoop,

Trampoline,

XCO,

PilatesReformer,

PilatesChair,

PilatesCadillac,

PilatesBarrel,

PilatesSpringboard,

BalanceBeam,

TreatmentTable,

RehabTable,

SlideBoard

Example:

["Barbell", "Bench"]

met

number | null

Example:

6

calories

object

Show child attributes

images

object[]

Show child attributes

videos

object[]

Show child attributes

difficulty

enum<string>

Available options:

Beginner,

Intermediate,

Advanced

Example:

"Intermediate"

intensity

enum<string>

Available options:

Beginner,

Below Average,

Average,

Above Average,

High Intensity

Example:

"Above Average"

Response

Exercise created. Returns its exerciseId and stored exercise.

data

object

required

Show child attributes

Health

OAuth

Platform

Company catalog

Clients

Calendar and bookings

Finance

Credits

Progress

Habits

Forms

Documents

Reports

Conversations

Exports

Webhooks

Workout

Create a workout exercise

Authorizations

Headers

Body

Response