Create a service booking

POST https://api.zenoti.com/v1/bookings

Creates a new service booking request. Returns a booking ID used for subsequent slot retrieval, reservation, and confirmation.

Before you begin

Permission: Manage API Keys (under Administrator) — Required to access Zenoti APIs.

Endpoint

POST /v1/bookings

Base URL: https://api.zenoti.com

Request

Headers

Header Required Description
Authorization Yes bearer {{access_token}}

Request body

Field Type Required Description
center_id string (GUID) Yes Center identifier
date date Yes Booking date
guests[].id string (GUID) Yes Guest identifier
guests[].items[].item_id string (GUID) Yes Service identifier
guests[].items[].therapist.Id string (GUID) No Preferred therapist (omit for any available)
guests[].items[].therapist.Gender integer No 0=Any, 1=Male, 2=Female, 3=Specific
guests[].items[].room.id string (GUID) No Preferred room

Response

Success (200 OK)

{
  "id": "c4d5e6f7-a8b9-0123-cdef-456789012345",
  "error": null
}

Response fields

Field Type Description
id string (GUID) Booking identifier (32-character GUID)
error object null on success

Example

curl --request POST \
  --url 'https://api.zenoti.com/v1/bookings' \
  --header 'Authorization: bearer {{access_token}}' \
  --header 'Content-Type: application/json' \
  --data '{
    "center_id": "a3614939-16c0-4a7b-bc33-a69b106d855c",
    "date": "2026-03-15",
    "guests": [{
      "id": "e5f6a7b8-c9d0-1e2f-3a4b-5c6d7e8f9a0b",
      "items": [{
        "item_id": "b7c8d9e0-f1a2-3b4c-5d6e-7f8a9b0c1d2e",
        "therapist": { "Gender": 0 }
      }]
    }]
  }'
const response = await fetch('https://api.zenoti.com/v1/bookings', {
  method: 'POST',
  headers: {
    'Authorization': 'bearer {{access_token}}',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
  center_id: 'a3614939-16c0-4a7b-bc33-a69b106d855c',
  date: '2026-03-15',
  guests: [
    {
      id: 'e5f6a7b8-c9d0-1e2f-3a4b-5c6d7e8f9a0b',
      items: [
        {
          item_id: 'b7c8d9e0-f1a2-3b4c-5d6e-7f8a9b0c1d2e',
          therapist: { Gender: 0 }
        }
      ]
    }
  ]
})
});
const data = await response.json();
import requests

response = requests.post(
    'https://api.zenoti.com/v1/bookings',
    headers={
        'Authorization': 'bearer {{access_token}}',
    },
    json={'center_id': 'a3614939-16c0-4a7b-bc33-a69b106d855c', 'date': '2026-03-15', 'guests': [{'id': 'e5f6a7b8-c9d0-1e2f-3a4b-5c6d7e8f9a0b', 'items': [{'item_id': 'b7c8d9e0-f1a2-3b4c-5d6e-7f8a9b0c1d2e', 'therapist': {'Gender': 0}}]}]}
)
data = response.json()
using var client = new HttpClient();
client.DefaultRequestHeaders.Add("Authorization", "bearer {{access_token}}");
var content = new StringContent(
    JsonSerializer.Serialize(new {
    centerId = "a3614939-16c0-4a7b-bc33-a69b106d855c",
    date = "2026-03-15",
    guests = new[] {
        new {
            id = "e5f6a7b8-c9d0-1e2f-3a4b-5c6d7e8f9a0b",
            items = new[] {
                new {
                    itemId = "b7c8d9e0-f1a2-3b4c-5d6e-7f8a9b0c1d2e",
                    therapist = new { Gender = 0 }
                }
            }
        }
    }
}),
    Encoding.UTF8, "application/json");
var response = await client.PostAsync(
    "https://api.zenoti.com/v1/bookings", content);
var data = await response.Content.ReadAsStringAsync();
require 'net/http'
require 'json'

uri = URI('https://api.zenoti.com/v1/bookings')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true
request = Net::HTTP::Post.new(uri)
request['Authorization'] = 'bearer {{access_token}}'
request['Content-Type'] = 'application/json'
request.body = { center_id: 'a3614939-16c0-4a7b-bc33-a69b106d855c', date: '2026-03-15', guests: [{ id: 'e5f6a7b8-c9d0-1e2f-3a4b-5c6d7e8f9a0b', items: [{ item_id: 'b7c8d9e0-f1a2-3b4c-5d6e-7f8a9b0c1d2e', therapist: { Gender: 0 } }] }] }.to_json
response = http.request(request)
data = JSON.parse(response.body)
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://api.zenoti.com/v1/bookings');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: bearer {{access_token}}',
    'Content-Type: application/json'
]);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode(['center_id' => 'a3614939-16c0-4a7b-bc33-a69b106d855c', 'date' => '2026-03-15', 'guests' => [['id' => 'e5f6a7b8-c9d0-1e2f-3a4b-5c6d7e8f9a0b', 'items' => [['item_id' => 'b7c8d9e0-f1a2-3b4c-5d6e-7f8a9b0c1d2e', 'therapist' => ['Gender' => 0]]]]]]));
$response = curl_exec($ch);
curl_close($ch);
$data = json_decode($response, true);

Error codes

Status Description
400 Bad request — invalid or missing required fields
401 Unauthorized — invalid or expired access token
429 Too many requests — rate limit exceeded (60/min)
503 center_id is missing or request is invalid