Create

Either patient_id or patient object is required. In order to create an appointment for an existing patient, patient_id can be utilized. During appointment creation, patient object can be used to create a new patient.

POST

/:tenantId/appointments

Body

{
    "user_id": 1,
    "patient_id": 1,
    "start_date": "2024-03-30 12:15",
    "end_date": "2024-03-30 12:45",
    "note": "",
    "notify": 1,
    "status": 1,
    "appointment_type_id":"1",
    "patient": {
        "first_name": "john",
        "last_name": "doe",
        "mobile": "+33 7 67 43 74 55",
        "external_id": "mdb-patient-123"
    },
    "source": "medibulut",
    "external_id": "mdb-appointment-123"
}

Key	Type	Required	Description
user_id	integer	yes	ID of the user associated with the appointment.
patient_id	integer	yes	ID of the patient associated with the appointment.
start_date	datetime	yes	The starting date and time of the appointment. Format YYYY-MM-DD HH:mm
end_date	datetime	yes	The ending date and time of the appointment. Format YYYY-MM-DD HH:mm
note	string	no	Additional notes for the appointment
notify	integer	no	Indicates if notifications are enabled. Sends notification SMS and emails to patients when enabled. 0: Disabled (default) 1: Enabled
status	integer	no	Status of the appointment. See appointment statuses 1: NO SHOW 2: ATTENDED 3: CANCELLED 4: WAITING 5: CONFIRMED
appointment_type_id	integer	yes	ID indicating the type of appointment.
patient.first_name	string	yes	First name of the patient.
patient.last_name	string	yes	Last name of the patient.
patient.mobile	string	no	Mobile number of the patient.
patient.external_id	string	no	External identifier for the patient.
source	string	no	The source of the record.
external_id	string	no	External identifier of the record.

Response

HTTP 201 Created

{
  "data": {
    "id": 1,
    "start_date": "2024-03-30T12:15:00.000000Z",
    "end_date": "2024-03-30T12:45:00.000000Z",
    "note": null,
    "user": {
      "id": 1,
      "name": "John Doe",
      "photo": null,
      "color": "#abcdef"
    },
    "patient": {
      "id": 1,
      "is_deleted": false,
      "mobile": "+1234567890",
      "name": "Jane Doe",
      "sms_consent": 2,
      "photo": null
    },
    "appointment_type_id": 1,
    "status": 1,
    "notify": 1,
    "resource_id": null
  }
}

HTTP 422 Unprocessable Content

{
    "message": "Must specify a valid user (and 1 more error)",
    "errors": {
        "user_id": [
            "Must specify a valid user"
        ],
        "patient_id": [
            "The selected patient id is invalid."
        ]
    }
}