---
title: "Create Payor Contract"
method: POST
path: "/public/v1/payor-contracts/"
tags: ["V1ContractsResource"]
---

# Create Payor Contract

`POST /public/v1/payor-contracts/`

## Request

- Base URL: `https://app.silnahealth.com/api`
- URL: `https://app.silnahealth.com/api/public/v1/payor-contracts/`
- Auth: HTTP bearer

## Request body

- V1ContractCreateBody
  - `provider_id` string, uuid, nullable: The provider's Silna identifier
  - `mso_id` string, uuid, nullable: The MSO's Silna identifier
  - `payor_id` string, uuid, required: The payor's Silna identifier
  - `clinician_id` string, uuid, nullable: The clinician's Silna identifier. Specify either clinician_id or provider_group_id.
  - `provider_group_id` string, uuid, nullable: The provider group's Silna identifier. Specify either clinician_id or provider_group_id.
  - `insurance_types` InsuranceType[]: Specifies which insurance types this contract covers. When no types are selected, the contract applies to all insurance types.
  - `plans` string[]: Select specific plans to include. When no plans are selected, the contract applies to all plans. Cannot be combined with excluded_plans.
  - `excluded_plans` string[]: Select specific plans to exclude. The contract will apply to all plans except those selected. Cannot be combined with plans.
  - `service_locations` string[], required: At least one service location is required.
  - `billing_service_location_id` string, uuid, nullable: The Silna identifier of the service location to bill under for this contract. When set, it overrides the service location on benefits checks and prior authorizations that use this contract. Must belong to the provider.
  - `task_types` ContractTaskType[]: Specifies which task types this contract applies to. When no task types are selected, the contract applies to all task types.
  - `medicaid_id` string, nullable: Medicaid ID
  - `ipa_required` boolean, nullable: When enabled, this contract only applies when the patient is associated with one of the contract's IPAs.

## Response `201`

- V1ContractCreateResponse
  - `id` string, uuid, required: The newly created contract's Silna identifier

## Other responses

- `400`
- `401`
- `404`
- `429`

## Changes

- **2026-10-07** `49900b6cc660`: 1 info
  - added the new optional request property `billing_service_location_id`
- **2026-10-06** `d1cefeb3bb82`: 1 info
  - added the new optional request property `task_types`
- **2026-09-03** `fd526e716e77`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/silnahealth/apis/silna-public-api/changes/public/v1/payor-contracts/post.md)

---

[API](https://skmtc.dev/silnahealth/apis/silna-public-api.md) - [All operations](https://skmtc.dev/silnahealth/apis/silna-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/silnahealth/apis/silna-public-api/revisions/06b4547aa602?raw)