Create a booking
POST/v1/bookings
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.
Request
Responses
- 201
- 400
- 401
- 403
- 404
- 409
- 502
The created booking.
validation_error
invalid_api_key
insufficient_scope
not_found — unknown appointment type
slot_unavailable
booking_failed