# Create an Appointment

Create an appointment reservation.

Endpoint: POST /v1/appointments
Version: 1.0.0
Security: apiKeyAuth, practiceGroupId

## Request fields (application/json):

  - `appointment_type_id` (string, required)

  - `location_id` (string, required)

  - `practitioner_id` (string, required)

  - `duration` (number, required)

  - `start_time` (string,null, required)
    ISO 8601 date format
    Example: "1989-04-11"

  - `patient_id` (string)

  - `billpayer_id` (string)

  - `reason` (string)

  - `suppress_mail` (boolean)

  - `suppress_availability_check` (boolean)

## Response 200 fields (application/json):

  - `id` (string, required)

  - `reserved_until` (string,null, required)

## Response 400 fields (application/json):

  - `error` (boolean, required)

  - `statusCode` (number, required)

  - `message` (array, required)

  - `message.code` (string, required)

  - `message.expected` (string, required)

  - `message.path` (array, required)


## Response 401 fields

## Response 404 fields

## Response 500 fields