# Add Insurance Policy

> Perform Add Insurance Policy through Brightree.

Source: [https://genhealth.ai/docs/workflows/integrations/brightree/brightree_add_insurance_policy](https://genhealth.ai/docs/workflows/integrations/brightree/brightree_add_insurance_policy)

Integration: [Brightree](https://genhealth.ai/docs/workflows/integrations/brightree.md)

- Handler: `brightree_add_insurance_policy`

- Connection type: `brightree`

## Inputs

- `patient_key` — Patient Key (expression, required)
  Required literal value or workflow expression.
- `carrier_id` — Carrier Id (expression, required)
  Required literal value or workflow expression.
- `payor_level` — Payor Level (number, required)
  Required numeric value.
- `subscriber_first_name` — Subscriber First Name (text, required)
  Required text value.
- `subscriber_last_name` — Subscriber Last Name (text, required)
  Required text value.
- `subscriber_state` — Subscriber State (text, required)
  Required text value.
- `start_date` — Start Date (text, required)
  Required text value.

## Outputs

- `success` — Success
- `policy_key` — Policy Key
- `message` — Message
- `error` — Error

Output schema completeness: `best_effort_declared`

## Safety

- External effect: `write`
- Confirmation recommended: no
- Retry safe: no
- Dry run supported: no

## Schemas

These schemas are first-pass authoring guidance. Runtime validation remains authoritative.

### Input schema

```json
{
  "type": "object",
  "required": [
    "patient_key",
    "carrier_id",
    "payor_level",
    "subscriber_first_name",
    "subscriber_last_name",
    "subscriber_state",
    "start_date"
  ],
  "properties": {
    "carrier_id": {
      "description": "Required literal value or workflow expression.",
      "x-workflow-field-type": "expression"
    },
    "start_date": {
      "type": "string",
      "description": "Required text value.",
      "x-workflow-field-type": "text"
    },
    "patient_key": {
      "description": "Required literal value or workflow expression.",
      "x-workflow-field-type": "expression"
    },
    "payor_level": {
      "type": "number",
      "description": "Required numeric value.",
      "x-workflow-field-type": "number"
    },
    "subscriber_state": {
      "type": "string",
      "description": "Required text value.",
      "x-workflow-field-type": "text"
    },
    "subscriber_last_name": {
      "type": "string",
      "description": "Required text value.",
      "x-workflow-field-type": "text"
    },
    "subscriber_first_name": {
      "type": "string",
      "description": "Required text value.",
      "x-workflow-field-type": "text"
    }
  },
  "additionalProperties": false
}
```

### Output schema

```json
{
  "type": "object",
  "properties": {
    "error": {},
    "message": {},
    "success": {},
    "policy_key": {}
  },
  "additionalProperties": true
}
```
