API referenceAppointments
Appointments
Book, reschedule, and cancel appointments.
Appointments belong to a customer. Status transitions: pending → reserved → confirmed; any state → cancelled. failed is terminal. Every status transition fires a webhook event (see Event types).
POST /v1/appointments— Create an appointmentGET /v1/appointments— List appointmentsGET /v1/appointments/{id}— Retrieve an appointmentPATCH /v1/appointments/{id}— Update an appointmentPOST /v1/appointments/{id}/cancel— Cancel an appointment
Health check
Smoke-test endpoint. Returns the project and livemode pair behind the Bearer key, useful for verifying that auth works without touching any resource.
Create an appointment
Creates a new appointment for an existing customer. Default status is `confirmed`; use `pending` or `reserved` if you want to create a slot without committing it. Fires the corresponding `appointment.created` or `appointment.confirmed` webhook event.