cURL
curl -X PATCH \
-H "Authorization: Bearer <access_token>" \
-H "Idempotency-Key: <stable_request_key>" \
-H "Content-Type: application/json" \
-d '{"phoneNumber":"+31612345678","assignedCoach":"<coachId>"}' \
https://api.fitsociety.io/public/v1/clients/<clientId>const options = {
method: 'PATCH',
headers: {
'Idempotency-Key': '<idempotency-key>',
Authorization: 'Bearer <token>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
firstName: 'Jane',
lastName: 'Doe',
email: 'jane@example.com',
phoneNumber: '+31612345678',
phoneCode: '+31',
dateOfBirth: '1990-01-01',
height: '172',
profession: 'Designer',
companyName: 'Acme',
timeZone: 'Europe/Amsterdam',
assignedCoach: '66f7b8b1e13c8d25f4d3d90a',
tagIds: ['<string>'],
assignTagIds: ['<string>'],
removeTagIds: ['<string>'],
location: {
addressLine1: '<string>',
addressLine2: '<string>',
zipCode: '<string>',
city: '<string>',
country: '<string>'
}
})
};
fetch('https://api.fitsociety.io/public/v1/clients/{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/clients/{clientId}"
payload = {
"firstName": "Jane",
"lastName": "Doe",
"email": "jane@example.com",
"phoneNumber": "+31612345678",
"phoneCode": "+31",
"dateOfBirth": "1990-01-01",
"height": "172",
"profession": "Designer",
"companyName": "Acme",
"timeZone": "Europe/Amsterdam",
"assignedCoach": "66f7b8b1e13c8d25f4d3d90a",
"tagIds": ["<string>"],
"assignTagIds": ["<string>"],
"removeTagIds": ["<string>"],
"location": {
"addressLine1": "<string>",
"addressLine2": "<string>",
"zipCode": "<string>",
"city": "<string>",
"country": "<string>"
}
}
headers = {
"Idempotency-Key": "<idempotency-key>",
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text){
"data": {
"client": {
"clientId": "66f7b8b1e13c8d25f4d3d90c",
"firstName": "Jane",
"lastName": "Doe",
"email": "jane@example.com",
"emailIsPlaceholder": false,
"relationship": {
"startedAt": "2026-07-14T10:00:00.000Z",
"assignedCoach": {
"coachId": "66f7b8b1e13c8d25f4d3d90a",
"name": "John Doe"
}
},
"phoneNumber": "+31612345678",
"gender": "Female",
"dateOfBirth": "1990-01-01T00:00:00.000Z",
"language": "nl",
"lastActiveAt": "2026-07-14T10:00:00.000Z",
"createdAt": "2026-07-14T10:00:00.000Z",
"location": {
"addressLine1": "Main street 1",
"addressLine2": "Apt 2",
"zipCode": "1011AB",
"city": "Amsterdam",
"country": "Netherlands"
},
"height": "172",
"timeZone": "Europe/Amsterdam",
"profession": "Designer",
"companyName": "Acme",
"customFields": [
{
"defaultLanguage": "string",
"key": "shirt_size",
"label": {},
"type": "text",
"value": "string",
"updatedAt": "2026-07-14T10:00:00.000Z"
}
]
}
},
"meta": {
"requestId": "4f849d7d-f4f1-45cc-b4b7-3984a3d17f83",
"rateLimit": {
"limit": 10,
"remaining": 9,
"resetSeconds": 1
},
"idempotency": {
"replayed": false
}
}
}Client records
Update a client
Updates safe Core CRM client fields. This endpoint does not delete clients or mutate payments, subscriptions, notes, or lifecycle removal fields.
PATCH
/
public
/
v1
/
clients
/
{clientId}
cURL
curl -X PATCH \
-H "Authorization: Bearer <access_token>" \
-H "Idempotency-Key: <stable_request_key>" \
-H "Content-Type: application/json" \
-d '{"phoneNumber":"+31612345678","assignedCoach":"<coachId>"}' \
https://api.fitsociety.io/public/v1/clients/<clientId>const options = {
method: 'PATCH',
headers: {
'Idempotency-Key': '<idempotency-key>',
Authorization: 'Bearer <token>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
firstName: 'Jane',
lastName: 'Doe',
email: 'jane@example.com',
phoneNumber: '+31612345678',
phoneCode: '+31',
dateOfBirth: '1990-01-01',
height: '172',
profession: 'Designer',
companyName: 'Acme',
timeZone: 'Europe/Amsterdam',
assignedCoach: '66f7b8b1e13c8d25f4d3d90a',
tagIds: ['<string>'],
assignTagIds: ['<string>'],
removeTagIds: ['<string>'],
location: {
addressLine1: '<string>',
addressLine2: '<string>',
zipCode: '<string>',
city: '<string>',
country: '<string>'
}
})
};
fetch('https://api.fitsociety.io/public/v1/clients/{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/clients/{clientId}"
payload = {
"firstName": "Jane",
"lastName": "Doe",
"email": "jane@example.com",
"phoneNumber": "+31612345678",
"phoneCode": "+31",
"dateOfBirth": "1990-01-01",
"height": "172",
"profession": "Designer",
"companyName": "Acme",
"timeZone": "Europe/Amsterdam",
"assignedCoach": "66f7b8b1e13c8d25f4d3d90a",
"tagIds": ["<string>"],
"assignTagIds": ["<string>"],
"removeTagIds": ["<string>"],
"location": {
"addressLine1": "<string>",
"addressLine2": "<string>",
"zipCode": "<string>",
"city": "<string>",
"country": "<string>"
}
}
headers = {
"Idempotency-Key": "<idempotency-key>",
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text){
"data": {
"client": {
"clientId": "66f7b8b1e13c8d25f4d3d90c",
"firstName": "Jane",
"lastName": "Doe",
"email": "jane@example.com",
"emailIsPlaceholder": false,
"relationship": {
"startedAt": "2026-07-14T10:00:00.000Z",
"assignedCoach": {
"coachId": "66f7b8b1e13c8d25f4d3d90a",
"name": "John Doe"
}
},
"phoneNumber": "+31612345678",
"gender": "Female",
"dateOfBirth": "1990-01-01T00:00:00.000Z",
"language": "nl",
"lastActiveAt": "2026-07-14T10:00:00.000Z",
"createdAt": "2026-07-14T10:00:00.000Z",
"location": {
"addressLine1": "Main street 1",
"addressLine2": "Apt 2",
"zipCode": "1011AB",
"city": "Amsterdam",
"country": "Netherlands"
},
"height": "172",
"timeZone": "Europe/Amsterdam",
"profession": "Designer",
"companyName": "Acme",
"customFields": [
{
"defaultLanguage": "string",
"key": "shirt_size",
"label": {},
"type": "text",
"value": "string",
"updatedAt": "2026-07-14T10:00:00.000Z"
}
]
}
},
"meta": {
"requestId": "4f849d7d-f4f1-45cc-b4b7-3984a3d17f83",
"rateLimit": {
"limit": 10,
"remaining": 9,
"resetSeconds": 1
},
"idempotency": {
"replayed": false
}
}
}Authorizations
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
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 - 200Example:
"booking-create-20260714-001"
Path Parameters
Body
application/json
Example:
"Jane"
Example:
"Doe"
Example:
"jane@example.com"
Example:
"+31612345678"
Example:
"+31"
Available options:
Male, Female, Other Example:
"1990-01-01"
Available options:
en, nl, de, fr, es Example:
"172"
Example:
"Designer"
Example:
"Acme"
Example:
"Europe/Amsterdam"
Example:
"66f7b8b1e13c8d25f4d3d90a"
Replace all assigned client tag ids.
Add these tags while keeping existing tags.
Remove these tags while keeping other existing tags.
Show child attributes
Show child attributes