---
title: "Changes to Create contract"
method: POST
path: "/api/contracts/v2"
---

# Changes to Create contract

`POST /api/contracts/v2`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 4 of 15 revisions.

- **2026-10-15** `97de8fddb088`: 1 warning
- **2026-09-17** `24b2d80d577a`: 6 breaking, 1 warning, 29 info
- **2026-09-12** `3a81ee81d4ed`: 1 info
- **2026-09-01** `1ae110d4149b`: 1 info

## Changes

- **2026-10-15** `97de8fddb088`: 1 warning
  - added the new `RT` enum value to the `contracting_provider/license_type` response property for the response status `200`
- **2026-09-17** `24b2d80d577a`: 6 breaking, 1 warning, 29 info
  - request property `contract_status` was restricted to a list of enum values
  - the `authorized_signatory` request property type changed from no type to `object`
  - the `contract_status` request property type changed from no type to `string`
  - the `contracting_provider_id` request property type changed from no type to `string`, and format from no format to `uuid`
  - the `rendering_provider_ids/items/` request property type changed from no type to `string`, and format from no format to `uuid`
  - the response's body type changed from no type to `object` for status `200`
  - deleted the `header` request parameter `Authorization`
  - the endpoint scheme security `OAuthScheme` was added to the API
  - added the new optional request property `authorized_signatory/email`
  - added the new optional request property `authorized_signatory/fax`
  - added the new optional request property `authorized_signatory/first_name`
  - added the new optional request property `authorized_signatory/last_name`
  - added the new optional request property `authorized_signatory/phone`
  - added the new optional request property `authorized_signatory/title`
  - added discriminator to `commercial_insurance_types` request property
  - added discriminator to `medicaid_insurance_types` request property
  - added discriminator to `medicare_insurance_types` request property
  - added the new `cancelled` enum value to the request property `contract_status`
  - added the new `effective` enum value to the request property `contract_status`
  - added the new `pending` enum value to the request property `contract_status`
  - added `subschema #1, subschema #2, subschema #3` to the `commercial_insurance_types` request property `oneOf` list
  - added `subschema #1, subschema #2, subschema #3` to the `medicaid_insurance_types` request property `oneOf` list
  - added `subschema #1, subschema #2, subschema #3` to the `medicare_insurance_types` request property `oneOf` list
  - added the optional property `authorized_signatory` to the response with the `200` status
  - added the optional property `contract_status` to the response with the `200` status
  - added the optional property `expiration_date` to the response with the `200` status
  - added the required property `commercial_insurance_types` to the response with the `200` status
  - added the required property `contract_id` to the response with the `200` status
  - added the required property `contracting_provider` to the response with the `200` status
  - added the required property `effective_date` to the response with the `200` status
  - added the required property `medicaid_insurance_types` to the response with the `200` status
  - added the required property `medicare_insurance_types` to the response with the `200` status
  - added the required property `payer` to the response with the `200` status
  - added the required property `provider_count` to the response with the `200` status
  - added the required property `regions` to the response with the `200` status
  - added the required property `rendering_provider_ids` to the response with the `200` status
- **2026-09-12** `3a81ee81d4ed`: 1 info
  - api operation id `create` removed and replaced with `v2_create_2`
- **2026-09-01** `1ae110d4149b`: 1 info
  - added the new `FC` enum value to the request property `regions/oneOf[subschema #1]/states/items/`

---

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