Bookings

Create a booking

Books a slot on an event type. Free event types confirm immediately; paid event types return a pending booking whose checkout_url(via the linked checkout) must be paid to confirm.

post/bookings

Request

  • Base URL: https://api.crevio.co/v1
  • URL: https://api.crevio.co/v1/bookings
  • Auth: API key in header Authorization

Headers

Idempotency-Keystring

Makes this write safe to retry: a repeat with the same key replays the first response instead of creating a second resource. Scoped to the account, remembered for 24 hours; reusing a key with a different payload is an error.

Request body

event_type_idstring required
start_timestring date-time required

UTC slot start (from the slots endpoint).

time_zonestring

Attendee's timezone (for their confirmation/reminders).

intake_answersobject[]

Answers to the event type's intake form (when one is attached). Stored as a FormSubmission.

price_variant_idstring

For paid event types: which price variant to charge. Defaults to the experience's first paid variant. The response includes a checkout with a purchase_url — redirect the customer there to pay; the booking confirms once paid.

Example request

{
  "event_type_id": "etype_abc123",
  "time_zone": "America/New_York",
  "price_variant_id": "pv_abc123"
}

Response

The created booking

objectstring required
idstring required
event_type_idstring required
customer_idstring nullable required
order_idstring nullable required
status'pending' | 'confirmed' | 'cancelled' | 'completed' | 'no_show' required
livemodeboolean required
time_zonestring required
attendee_namestring nullable required
attendee_emailstring nullable required
attendee_phonestring nullable required
location_detailsstring nullable required
meet_urlstring nullable required
cancel_reasonstring nullable required
created_atstring date-time required
updated_atstring date-time required
intake_answersobject[] required
start_timestring date-time required
end_timestring date-time required
cancelled_atstring date-time nullable required

Changes

No recorded changes to this operation across all 2 revisions of this API.