---
title: "Create contract"
method: POST
path: "/api/contracts/v2"
tags: ["v2"]
---

# Create contract

`POST /api/contracts/v2`

Creates a new contract within the user's current organization

## Headers

- `Authorization` string, required

## Request body

- object
  - `effective_date` string, required — ISO 8601 date; formatted YYYY-MM-DD (i.e. 2012-02-01)
  - `expiration_date` string — ISO 8601 date; formatted YYYY-MM-DD (i.e. 2012-02-01)
  - `regions` union, required
    - object
      - `type` 'states', required — Discriminator value: states
      - `states` TypeCommonsState[], required
    - object
      - `type` 'national', required — Discriminator value: national
  - `contract_status` V2ContractStatus — unresolved $ref
  - `authorized_signatory` V2AuthorizedSignatory — unresolved $ref
  - `commercial_insurance_types` V2InsuranceTypes, required — unresolved $ref
  - `medicare_insurance_types` V2InsuranceTypes, required — unresolved $ref
  - `medicaid_insurance_types` V2InsuranceTypes, required — unresolved $ref
  - `contracting_provider_id` V2ContractingProviderId, required — unresolved $ref
  - `rendering_provider_ids` V2RenderingProviderid[], required — A rendering provider isn't contracted directly with the payer but can render services under the contract held by the contracting provider. Max items is 4000. — unresolved $ref
  - `payer_uuid` string, uuid, required — The UUID of the insurance company under agreement to the contract

## Response `200`

Response with status 200

- V2ContractWithProviders — unresolved $ref

---

[API](https://skmtc.net/joincandidhealth/apis/api-reference.md) · [All operations](https://skmtc.net/joincandidhealth/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/joincandidhealth/api-reference/revisions/7cc5974e4128/schema)