Book Appointment

POST /v1.0/appointments

Books an available appointment slot for a patient with a practitioner.

Parameters

Name	In	Type	Description	Required
x-sully-organization-id	header	string	Organization ID for multi-tenant support.	Yes
x-sully-transaction-id	header	string	Transaction ID for tracking purposes.	Yes

Request Body (
application/json
)
{
  "patient_id": "string",
  "patient_first_name": "string",
  "patient_last_name": "string",
  "patient_date_of_birth": "2025-07-15",
  "patient_phone_number": "string",
  "patient_email": "[e-mail]",
  "practitioner_id": "string",
  "practitioner_email": "[e-mail]",
  "practitioner_first_name": "string",
  "practitioner_last_name": "string",
  "start_date_time": "2025-07-15T19:09:11.705Z",
  "end_date_time": "2025-07-15T19:09:11.705Z",
  "reason": "string",
  "notes": "string"
}

Responses

• 201: Appointment successfully booked (application/json)

• 400: Bad request due to invalid input (application/json)

• 404: Practitioner not found or no slots available on the requested date (application/json)