Skip to main content
POST
Book an appointment

Authorizations

Authorization
string
header
required

An API key from Settings > API keys. Scopes: business:read, business:write, calls:read, contacts:read, contacts:write, appointments:read, appointments:write, messages:read, knowledge:write, webhooks:manage.

Headers

Idempotency-Key
string

A unique value, up to 255 characters, that makes retries of this request safe for 24 hours.

Maximum string length: 255

Body

application/json
service_id
string<uuid>
required

Stable identifier (UUID).

starts_at
string<date-time>
required

Start time. Use a starts_at value from GET /availability.

contact_id
string<uuid>

An existing contact with a phone number. Provide contact_id or contact_phone.

contact_phone
string

Phone number in E.164 format.

Pattern: ^\+[1-9]\d{6,14}$
contact_name
string
Required string length: 1 - 200
staff_id
string<uuid>

Book with this active staff member. Without it, LobbyStack picks one who is free.

True only if the customer agreed to receive confirmation and reminder texts.

Response

Created

data
object
required