---
title: "Changes to Create"
method: POST
path: "/appointments/v1"
---

# Changes to Create

`POST /appointments/v1`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 5 of 15 revisions.

- **2026-10-29** `d8b0a61873e2`: 6 info
- **2026-09-24** `4074901c170f`: 2 info
- **2026-09-19** `72fc5ca65ba5`: 2 warning, 12 info
- **2026-09-17** `24b2d80d577a`: 8 breaking, 1 warning, 46 info
- **2026-09-12** `3a81ee81d4ed`: 1 info

## Changes

- **2026-10-29** `d8b0a61873e2`: 6 info
  - added the new optional request property `devices`
  - added the new optional request property `ready_reason`
  - added the new optional request property `rooms`
  - added the optional property `devices` to the response with the `200` status
  - added the optional property `ready_reason` to the response with the `200` status
  - added the optional property `rooms` to the response with the `200` status
- **2026-09-24** `4074901c170f`: 2 info
  - added the new optional request property `cancellation_reason`
  - added the optional property `cancellation_reason` to the response with the `200` status
- **2026-09-19** `72fc5ca65ba5`: 2 warning, 12 info
  - added the new `CHECKED_OUT` enum value to the `status` response property for the response status `200`
  - added the new `NO_SHOW` enum value to the `status` response property for the response status `200`
  - added the new optional request property `appointment_reason_detail`
  - added the new optional request property `attending_doctor/addresses/items/administrative_area`
  - added the new optional request property `checked_out_timestamp`
  - added the new optional request property `medical_necessity_verified`
  - added the new optional request property `prior_authorization_status`
  - added the new `CHECKED_OUT` enum value to the request property `status`
  - added the new `NO_SHOW` enum value to the request property `status`
  - added the optional property `appointment_reason_detail` to the response with the `200` status
  - added the optional property `attending_doctor/addresses/items/administrative_area` to the response with the `200` status
  - added the optional property `checked_out_timestamp` to the response with the `200` status
  - added the optional property `medical_necessity_verified` to the response with the `200` status
  - added the optional property `prior_authorization_status` to the response with the `200` status
- **2026-09-17** `24b2d80d577a`: 8 breaking, 1 warning, 46 info
  - added the new required request property `patient_id`
  - added the new required request property `service_duration`
  - added the new required request property `services`
  - added the new required request property `start_timestamp`
  - the request's body type changed from no type to `object`
  - the response's body type changed from no type to `object` for status `200`
  - the `content` response's property type changed from no type to `object` for status `404`
  - the `content` response's property type changed from no type to `object` for status `409`
  - deleted the `header` request parameter `Authorization`
  - the endpoint scheme security `OAuthScheme` was added to the API
  - added the new optional request property `appointment_details`
  - added the new optional request property `attending_doctor`
  - added the new optional request property `automated_eligibility_check_complete`
  - added the new optional request property `checked_in_timestamp`
  - added the new optional request property `estimated_copay_cents`
  - added the new optional request property `estimated_patient_responsibility_cents`
  - added the new optional request property `location_resource_id`
  - added the new optional request property `not_ready_reason`
  - added the new optional request property `notes`
  - added the new optional request property `patient_deposit_cents`
  - added the new optional request property `placer_appointment_id`
  - added the new optional request property `placer_system_name`
  - added the new optional request property `ready_source`
  - added the new optional request property `status`
  - added the new optional request property `work_queue`
  - added the optional property `appointment_details` to the response with the `200` status
  - added the optional property `attending_doctor` to the response with the `200` status
  - added the optional property `automated_eligibility_check_complete` to the response with the `200` status
  - added the optional property `checked_in_timestamp` to the response with the `200` status
  - added the optional property `content/data` to the response with the `404` status
  - added the optional property `content/data` to the response with the `409` status
  - added the optional property `content/latest_version` to the response with the `409` status
  - added the optional property `estimated_copay_cents` to the response with the `200` status
  - added the optional property `estimated_patient_responsibility_cents` to the response with the `200` status
  - added the optional property `location_resource_id` to the response with the `200` status
  - added the optional property `not_ready_reason` to the response with the `200` status
  - added the optional property `notes` to the response with the `200` status
  - added the optional property `patient_deposit_cents` to the response with the `200` status
  - added the optional property `placer_appointment_id` to the response with the `200` status
  - added the optional property `placer_system_name` to the response with the `200` status
  - …15 more
- **2026-09-12** `3a81ee81d4ed`: 1 info
  - api operation id `create` removed and replaced with `v1_create`

---

[Operation](https://skmtc.dev/joincandidhealth/apis/api-reference/docs/appointments/v1/post.md) - [API](https://skmtc.dev/joincandidhealth/apis/api-reference.md) - [Page](https://skmtc.dev/joincandidhealth/apis/api-reference/changes/appointments/v1/post)