> ## Documentation Index
> Fetch the complete documentation index at: https://docs.helloannie.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Insurances

> Configure insurance acceptance for accurate coverage responses

Insurance configurations help your agent answer coverage questions accurately. Instead of burying insurance info in FAQs, use the dedicated insurance module so Annie can respond intelligently to questions like "Do you take my insurance?"

**Use insurances for:**

* Which providers you accept
* In-network vs out-of-network status
* Plan-specific notes (PPO vs HMO, filing policies)

## Creating an Insurance

<CodeGroup>
  ```javascript Node.js theme={null}
  const response = await fetch(
    "https://api.helloannie.com/v1/organizations/YOUR_ORG_ID/insurances",
    {
      method: "POST",
      headers: {
        "Authorization": "Bearer YOUR_API_KEY",
        "Content-Type": "application/json"
      },
      body: JSON.stringify({
        name: "Delta Dental",
        type: "PPO",
        status: "IN_NETWORK",
        notes: "Premier and PPO plans accepted"
      })
    }
  )
  ```

  ```python Python theme={null}
  import requests

  response = requests.post(
      "https://api.helloannie.com/v1/organizations/YOUR_ORG_ID/insurances",
      headers={
          "Authorization": "Bearer YOUR_API_KEY",
          "Content-Type": "application/json"
      },
      json={
          "name": "Delta Dental",
          "type": "PPO",
          "status": "IN_NETWORK",
          "notes": "Premier and PPO plans accepted"
      }
  )
  ```

  ```bash cURL theme={null}
  curl -X POST https://api.helloannie.com/v1/organizations/YOUR_ORG_ID/insurances \
    -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{
      "name": "Delta Dental",
      "type": "PPO",
      "status": "IN_NETWORK",
      "notes": "Premier and PPO plans accepted"
    }'
  ```
</CodeGroup>

## Insurance Fields

<ParamField body="name" type="string" required>
  The insurance provider name. Annie matches this case-insensitively against known providers.

  **Example:** `"Delta Dental"`, `"Cigna"`, `"Aetna"`
</ParamField>

<ParamField body="type" type="string" required>
  The plan type.

  **Options:** `PPO`, `HMO`, `EPO`, `MEDICAID`, `MEDICARE`
</ParamField>

<ParamField body="status" type="string" required>
  Your acceptance status for this insurance.

  | Status         | Meaning                                                                                                                  |
  | :------------- | :----------------------------------------------------------------------------------------------------------------------- |
  | `IN_NETWORK`   | You're an in-network provider                                                                                            |
  | `ACCEPTED`     | You accept the insurance. Similar to `CAN_FILE`, but helps adjust verbiage to be less direct about being out of network. |
  | `CAN_FILE`     | Similar to `ACCEPTED`, but more direct about being out of network. Means you can file claims on the patient's behalf     |
  | `CONDITIONAL`  | Accepted with conditions (explain in notes)                                                                              |
  | `NOT_ACCEPTED` | You don't accept this insurance                                                                                          |
</ParamField>

<ParamField body="notes" type="string">
  Additional context Annie can use when discussing this insurance.

  **Example:** `"Premier and PPO plans only. HMO plans not accepted."`
</ParamField>

***

<Card title="Insurances API" icon="code" href="/api-reference/insurances/list-insurances">
  See the full API reference for insurance endpoints.
</Card>