Appointments

Create a booking (charges credits + sends notifications)

Create (book) an appointment on behalf of the API key's user.

Reuses BookingsHandler.handle_create verbatim — same host selection, conflict checks, credit charge (~20 credits), calendar push, attendee notifications, and EDA emit as an in-app booking. Surfaces the handler's 402 (insufficient credits) / 409 (slot conflict) / 404 (event type) untouched.

post/appointments/bookings

Request

  • Base URL: https://be.graph8.com/api/v1
  • URL: https://be.graph8.com/api/v1/appointments/bookings
  • Auth: HTTP bearer

Headers

Authorizationstring nullable
X-Target-Org-Idstring nullable

Request body

event_type_idinteger required
start_timestring required
end_timestring nullable
override_availabilityboolean
locationstring nullable
responsesobject nullable
guestsstring[] nullable
metadataobject nullable
recurring_event_idstring nullable
languagestring
slot_uidstring nullable

Response

Successful Response

object required

Changes

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