Overview

Create a new booking (appointment or event attendance). Available for Staff, Directory, and Application tokens.

Important: Always provide client_id parameter. Without it, the endpoint attempts to create a client from form_data and returns 'First name can't be blank' errors.

Token Authorization

• Staff tokens: Client must belong to the same business as the staff member
• Directory tokens: Business must be a member of the directory (requires directory_member record)

Booking Types

This endpoint supports two types of bookings with different required parameters:

Appointment Booking (default)

When event_instance_id is NOT provided:

• Required: business_id, service_id, staff_id
• Required one of: start_time OR optional_times

Event Registration

When event_instance_id IS provided:

• Required: business_id, event_instance_id

Client Identification

• Use client_id to book for an existing client (required for Staff/App tokens)
• Without client_id, the endpoint expects form_data for client creation (used by client-facing booking flows)