---
title: "Create an insurance policy"
method: POST
path: "/practices/{practice_id}/insurance-policies"
tags: ["insurance_policies"]
---

# Create an insurance policy

`POST /practices/{practice_id}/insurance-policies`

## Request

- Base URL: `sandbox.collectly.co/api/api/partners/v1` (relative, and the document’s source URL is not known)
- URL: `sandbox.collectly.co/api/api/partners/v1/practices/{practice_id}/insurance-policies`
- Auth: API key in header `Authorization`

Create a new insurance policy record linking a patient to an insurance company, including member ID, priority, and copay details.

## Path parameters

- `practice_id` string, required

## Request body

- InsurancePolicy
  - `clearinghouse_copay` number, nullable
  - `company_id` integer
  - `created_at` string, date-time
  - `external_id` string, nullable
  - `external_insurance_company_id` string: Provide this to automatically look up and assign the internal company_id
  - `extra` object
  - `id` integer
  - `in_network_effective_location_ids` integer[]
  - `is_archived` boolean
  - `is_external` boolean
  - `is_manually_verified` boolean
  - `is_photos_exist_in_ehr` boolean
  - `manual_copay` number, nullable
  - `member_id` string, nullable
  - `name` string
  - `note` string, nullable
  - `patient_id` string, required: Patient ID from your integration who owns the resource
  - `photo_back_upload_id` unknown
  - `photo_front_upload_id` unknown
  - `priority` 'primary' | 'secondary' | 'tertiary' | 'other'

## Response `200`

OK

- InsurancePolicy
  - `clearinghouse_copay` number, nullable
  - `company_id` integer
  - `created_at` string, date-time
  - `external_id` string, nullable
  - `external_insurance_company_id` string: Provide this to automatically look up and assign the internal company_id
  - `extra` object
  - `id` integer
  - `in_network_effective_location_ids` integer[]
  - `is_archived` boolean
  - `is_external` boolean
  - `is_manually_verified` boolean
  - `is_photos_exist_in_ehr` boolean
  - `manual_copay` number, nullable
  - `member_id` string, nullable
  - `name` string
  - `note` string, nullable
  - `patient_id` string, required: Patient ID from your integration who owns the resource
  - `photo_back_upload_id` unknown
  - `photo_front_upload_id` unknown
  - `priority` 'primary' | 'secondary' | 'tertiary' | 'other'

---

[API](https://skmtc.dev/collectly/apis/partners1.md) - [All operations](https://skmtc.dev/collectly/apis/partners1/llms.txt) - [OpenAPI document](https://skmtc.dev/collectly/apis/partners1/revisions/a45575a6e4b8?raw)