appointments

CRM create scheduled appointment

Create a scheduled appointment from CRM and optionally start immediate Stripe charge when the appointment is within 48 hours.

post/api/appointments/crm/create-scheduled

Request body

patient_idstring uuid required

Patient UUID

operator_idstring uuid nullable

Operator UUID; required for admin callers, taken from the request scope otherwise

appointment_datetimestring date-time required

Appointment datetime (ISO)

operator_professionstring nullable

Operator profession hint

is_free_appointmentboolean nullable

Admin-only free appointment flag

location_typestring nullable

Location type (online/presenza/in_person)

expert_in_personboolean nullable

Whether the expert must be physically in person

room_availability_idstring uuid nullable

Room availability UUID for in-person appointments

room_idstring uuid nullable

Room UUID for in-person appointments

clinic_location_idstring uuid nullable

Clinic location UUID for in-person appointments

Successful Response

successboolean required

Whether the operation completed successfully

messagestring required

Human-readable result message

codestring nullable

Stable application error/result code

appointment_idstring nullable

Created appointment UUID, if available

joint_appointment_idsstring[]

Both appointment UUIDs when the created appointment is a joint one

has_active_couponboolean

Whether the patient has an active coupon for the appointment

No recorded changes to this endpoint across all 1 revision of this API.