Bookings
The booking lifecycle, status machine, and available operations.
Booking lifecycle
| Status | Description |
|---|---|
DRAFT | Created, routing in progress (transient — milliseconds to seconds) |
SCHEDULED | Assigned to a team member, confirmed |
PENDING_CONFIRMATION | Awaiting host confirmation (event types with requiresConfirmation: true) |
COMPLETED | Meeting happened |
CANCELLED | Cancelled by host or via API |
NO_SHOW | Attendee did not attend |
RESCHEDULED | Replaced by a newer booking |
Idempotency
For POST /bookings, pass an idempotency key to safely retry without creating duplicates:
If a booking with that key already exists, the existing booking is returned with status 200.
Filtering
Supported filters: status, eventTypeId, assignedToId, attendeeEmail, startDate, endDate.