Create a booking (charges credits + sends notifications)

POST

/appointments/bookings

• Production
• QA

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.

Authorizations

• BearerAuth

Parameters

Header Parameters

X-Target-Org-Id

Any of:

string

string

null

null

Request Body ^required

object

attendees

required

Array<object>

object

email

required

string

name

required

string

phone_number

Any of:

string

string

null

null

time_zone

Any of:

string

string

null

null

end_time

Any of:

string

string

null

null

event_type_id

required

integer

guests

Any of:

Array<string>

Array<string>

null

null

language

string

default: en

location

Any of:

string

string

null

null

metadata

Any of:

object

object

key

additional properties

any

null

null

override_availability

boolean

recurring_event_id

Any of:

string

string

null

null

responses

Any of:

object

object

key

additional properties

any

null

null

selected_conferencing

Any of:

LocationItem

A single location option on an event type.

object

address

Any of:

string

string

null

null

display_label

Any of:

string

string

null

null

kind

required

Rich location types for event types.

string

Allowed values: in_person_host in_person_attendee phone_host phone_attendee link conferencing custom

link

Any of:

string

string

null

null

phone

Any of:

string

string

null

null

provider

Any of:

string

string

null

null

public

boolean

default: true

null

null

selected_location

Any of:

LocationItem

A single location option on an event type.

object

address

Any of:

string

string

null

null

display_label

Any of:

string

string

null

null

kind

required

Rich location types for event types.

string

Allowed values: in_person_host in_person_attendee phone_host phone_attendee link conferencing custom

link

Any of:

string

string

null

null

phone

Any of:

string

string

null

null

provider

Any of:

string

string

null

null

public

boolean

default: true

null

null

slot_uid

Any of:

string

string

null

null

start_time

required

string

Responses

201

Successful Response

object

key

additional properties

any

422

Validation Error

object

detail

Array<object>

object

loc

required

Array

msg

required

string

type

required

string