Bookings

Appointments your customers booked, and the kinds of appointment on offer. Read them, enter one on a customer's behalf, and move, cancel or close one out — cancelling refunds and mails the customer the same way the planner does. Availability and schedules stay in the planner.

📄️List bookings

Filterable, sortable, paginated list of appointments. Requires the `read:bookings` scope.

📄️Create a booking

Book an appointment on a customer's behalf. It is confirmed immediately and counts as entered by hand (`source: PLANNER`), so no payment is taken — a paid type stays `UNPAID` until you settle it and mark it paid. The customer receives the normal confirmation mail. `startsAt` must be a slot the availability engine offers; anything else answers 409 `slot_unavailable`. Requires the `write:bookings` scope.

📄️Get a booking

Fetch a single appointment. Requires the `read:bookings` scope.

📄️List appointment types

The kinds of appointment your customers can book. Use a type's `slug` when creating a booking. Requires the `read:bookings` scope.

📄️Cancel a booking

Cancel an appointment, release its slot and mail the customer. Set `refund` to send a paid customer their money back. Requires the `write:bookings` scope.

📄️Reschedule a booking

Move a confirmed future appointment to another slot, re-push it to the connected calendar and send a new confirmation. Requires the `write:bookings` scope.

📄️Mark a booking completed

Record that the appointment took place. Requires the `write:bookings` scope.

📄️Mark a booking as a no-show

Record that the customer did not turn up. Requires the `write:bookings` scope.

📄️Mark a booking paid

Record that a booking settled outside Stripe (cash, invoice, transfer) has been paid. Requires the `write:bookings` scope.