ZenotiHelp

Use service booking APIs

ZTZenoti Docs Team Updated March 7, 2026 3 min readGuide

The service booking APIs provide the endpoints for the booking lifecycle: creating bookings, retrieving available time slots, reserving and confirming slots, rescheduling, and cancelling. These are the core APIs used in the Book services using APIs workflow.

For complete endpoint documentation including request/response schemas and code examples, see the individual API reference articles linked below.


On this page


Before you begin

  • You need a valid API key or access token. See Set up API authentication.
  • Services, employee schedules, and center hours must be configured before creating bookings.

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

Create a service booking

POST /v1/bookings

Creates a service booking request. Supports single and group bookings, therapist preferences, and family member appointments.

Parameter Type Required Description
center_id guid Yes Center identifier
date date Yes Booking date
guests object Yes Guest and service details
guests.id guid Yes Guest identifier
guests.items array Yes Service and therapist selections
guests.items[].item_id guid Yes Service identifier
guests.items[].therapist object No Therapist preference (Id, Gender: 0=Any, 1=Male, 2=Female, 3=Specific)
guests.items[].room object No Room selection (id)
guests.items[].add_ons array No Add-on service items
is_family_booking boolean No Whether this is a family member booking
host_id guid No Host guest ID for group bookings

Response: id (the booking ID, a 32-character GUID).

Retrieve available slots

GET /v1/bookings/{booking_id}/slots

Retrieves available time slots for a booking. If no slots are available on the requested day, returns the next available slot within the week.

Parameter Type Required Description
booking_id guid Yes Booking identifier from the create step

Response: slots (array with Time, Available, SalePrice, Priority, Warnings), future_days (availability on upcoming days), next_available_day.

Reserve a slot

POST /v1/bookings/{booking_id}/slots/reserve

Reserves a selected time slot for the booking. The reservation has an expiry time, after which the slot becomes available again.

Parameter Type Required Description
booking_id guid Yes Booking identifier
slot_time datetime Yes The time slot to reserve
create_invoice boolean No Generate a temporary invoice during reservation (default: false)

Response: is_reserved, reservation_id, expiry_time, blocking_time, invoices (guest details, invoice_id, appointment items with therapist, room, equipment, start and end times).

Confirm a booking

POST /v1/bookings/{booking_id}/slots/confirm

Confirms a reserved booking, finalizing the appointment.

Parameter Type Required Description
booking_id guid Yes Booking identifier
notes string No Guest notes
group_name string No Name for group appointments

Response: is_confirmed, invoice (with guest, invoice_id, and items containing service, therapist, room, equipment, timing, and appointment IDs).

Reschedule a booking

Rescheduling is a multi-step process:

  1. Create a new booking with the invoice_id and invoice_item_id from the original confirmed booking.
  2. Retrieve available slots using the new booking ID.
  3. Reserve a slot.
  4. Confirm the rescheduled booking.

POST /v1/bookings

Include the original invoice_id and invoice_item_id in the request body along with the new booking details.

Cancel a booking

PUT /v1/invoices/{invoice_id}/cancel

Cancels a booking by removing all appointments and purchases linked to the invoice. If cancellation charges are configured, they are applied automatically.

Parameter Type Required Description
invoice_id string Yes Invoice identifier for the booking

Response: success, is_charge_applied (whether a cancellation fee was assessed).

Note: If payments have already been applied to the invoice, they must be removed before cancellation.

API reference

Was this article helpful?
Your feedback helps us improve our documentation.