Create Booking
Bookings
Create Booking
Create a new booking for a customer
POST
Create Booking
Endpoint
Authentication
Your API key
Unique key to prevent duplicate bookings on retryExample:
booking-user123-1701619200000Must be
application/jsonRequest Body
Your organization slug (from your booking page URL)Example:
acme-salonSlug of the service to bookExample:
haircutStart time in ISO 8601 format (UTC)Example:
2025-12-03T14:00:00ZEnd time in ISO 8601 format (UTC)Example:
2025-12-03T15:00:00ZIANA timezone name for display purposesExample:
America/New_YorkCustomer contact information
Number of people (default: 1)
ID of specific host/staff member (if available in slot)
ID of team (if available in slot)
Optional notes or special requests
Response
The created booking confirmation
Calendar invite details
Examples
Response Example
Complete Booking Flow
Best Practices
1. Always Use Idempotency Keys
1. Always Use Idempotency Keys
Prevent duplicate bookings if requests are retried:The same key returns the same result for 24 hours.
2. Validate Availability Before Booking
2. Validate Availability Before Booking
Always check that the slot is available:
3. Handle 409 Conflict Errors
3. Handle 409 Conflict Errors
The slot might be booked between checking and creating:
4. Validate Contact Information
4. Validate Contact Information
Validate email and phone before sending:
5. Send Confirmation to Customer
5. Send Confirmation to Customer
Always confirm the booking to the customer:
Errors
Invalid request data or missing required fields
Invalid or missing API key
Organization or service not found
Time slot no longer available
Business validation failed
Rate limit exceeded (10 bookings/minute)
Related Endpoints
Get Availability
Query available time slots before booking
Lookup Booking
Look up a booking by confirmation number
Cancel Booking
Cancel an existing booking
Reschedule Booking
Move booking to a new time

