SoftSolzSoftSolz
Sign up
HomeAPI GuideAPI ReferenceWidget Tester
appointments

Create a resource.

Create a resource.

POSThttps://app.softsolz.uk/api/v1/services/appointments/resources

Recent Requests

Kept only in this browser
TimeStatusTook
Send a request with Try it to see it here.

Headers

Authorizationstringrequired

Bearer token: `Bearer sk_live_...` (or `sk_test_...` for sandbox). A login token will not work here.

Idempotency-Keystring

Optional idempotency key for safe retries.

Body Params

namestringrequired

Display name.

kindstring

staff, contractor, room, equipment, vehicle, team, or your own word such as chair or studio. Lower case letters, numbers, and underscores.

emailstring

Email address.

phonestring

Phone number in international format.

timezonestring

IANA timezone, for example Europe/London.

colorstring

Colour used on the calendar.

skillsarray of strings

Skills this resource holds, used for matching.

capacityinteger

Places available. 1 is one-to-one; above 1 enables group booking.

is_activeboolean

Whether this record is in use.

custom_fieldsobject

Your own extra fields, keyed by the definitions in workspace settings.

Response

Response Body

idstringUnique identifier.
kindstringstaff, contractor, room, equipment, vehicle, team, or your own word such as chair or studio.
namestringDisplay name.
emailstring | nullEmail address.
phonestring | nullPhone number in international format.
timezonestring | nullIANA timezone, for example Europe/London.
skillsarray of stringsSkills this resource holds, used for matching.
capacityintegerPlaces available. 1 is one-to-one; above 1 enables group booking.
is_activebooleanWhether this record is in use.
created_atstringWhen the record was created.
updated_atstringWhen the record was last changed. Round-trip as expected_updated_at to guard against stale writes.

Request

curl --request POST \
  --url https://app.softsolz.uk/api/v1/services/appointments/resources \
  --header 'Authorization: Bearer sk_live_your_key' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "Dana Whitfield",
  "kind": "staff",
  "timezone": "Europe/London"
}'

Credentials

Sent as a Bearer token and used in the samples above and in Try it. Kept only in this browser tab until you close it. Use an sk_test_ key to stay in your sandbox.

Response · 201

{
  "data": {
    "id": "3",
    "kind": "staff",
    "name": "Dana Whitfield",
    "email": "dana@example.com",
    "phone": "your-phone",
    "timezone": "Europe/London",
    "skills": [
      "gas-safe"
    ],
    "capacity": 1,
    "is_active": true,
    "created_at": "2026-01-01T09:00:00.000Z",
    "updated_at": "2026-01-01T09:00:00.000Z"
  }
}