Create a booking

Parameters

X-Correlation-IDstringheader

Optional opaque request correlation ID for tracing API calls across systems. Billing audit paths persist only UUIDv4-shaped values and drop free-form values.

Example: 33333333-3333-4333-8333-333333333333

Idempotency-Keystringheader

Optional idempotency key for safe retries of booking creation.

Example: booking-create-2026-05-13-001

appointmentTypeSlugstring

Optional selected appointment type slug. When supplied, it must be active for the selected slot provider organization and specialty.

Example: adipositas-erstberatung

externalPatientRefstringRequired

External patient reference from the integrating system.

Example: patient-12345

intakeResponsesobject

Appointment-type-specific intake answers keyed by custom intake field key. Required custom fields are validated against the selected appointment type.

Example: {"companion-count":1,"visit-reason":"Erstberatung zur Adipositas-Therapie"}

patientEmailstring (email)

Optional patient email.

patientNamestring

Optional patient display name.

patientPhonestring

Optional patient phone.

slotIdstring (uuid)Required

Slot to book.

Example: 0d6b61b1-a99e-480c-878f-b8f5d1be0983