Skip to main content
A booking is a time slot a customer reserves on one of the business’s bookable services. The service is an event type; its open times come from an availability schedule; a paid service is charged through the price variants linked to the event type’s experience.

The pieces

Event type fields worth knowing:

Free and paid

An event type is free to book unless a paid price variant is linked to the experience_id it returns:
POST /bookings on a free event type confirms at once. On a paid one it returns a pending booking with a checkout_url; the booking is confirmed when that checkout is paid. Pass price_variant_id to choose which price to charge; it defaults to the experience’s first paid variant.

Reading availability

GET /event_types/{id}/slots?from=2026-11-10&to=2026-11-17&timezone=America/Chicago returns open slots between two dates (defaults: today and 14 days out). It already accounts for the schedule, buffers, notice, existing bookings and, when connected, the business’s Google Calendar busy times. timezone sets the local_start_time in the response; book with the slot’s UTC start_time.

Booking, rescheduling and cancelling

  • Book: POST /bookings with event_type_id, the slot’s start_time, the attendee, their time_zone (for confirmations and reminders), and intake_answers when the event type has an intake form.
  • Reschedule: POST /bookings/{id}/reschedule with a new start_time. Crevio checks the time is still free and updates the calendar event. Read the slots first.
  • Cancel: POST /bookings/{id}/cancel frees the slot, removes the calendar event and emails the attendee.
Cancelling a paid booking does not refund it. Refund its order separately with POST /refunds.

Next steps