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": "user@example.com",
  "practitioner_id": "string",
  "practitioner_email": "user@example.com",
  "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)

Last updated