Create Basic Policy

Creates a new basic policy. The request body is a flat object of company-configured fields plus a nested exposures array.

Each exposure’s id (and the top-level primaryInsured) must reference an existing exposure record — create exposures first via the Exposures API.

Additional company-configured fields (custom text, number, option-set, or object fields) may be included alongside the required fields below.

Required permission: company.policy:create

POST /api/v1/external/companies/{companyId}/policies

Create Basic Policy

cURL

curl --request POST \
  --url https://app.aiinsurance.io/api/v1/external/companies/{companyId}/policies \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "policyNumber": "POL-2026-0001",
  "policyStartDate": {
    "date": "2026-01-01",
    "timezone": "America/New_York"
  },
  "policyEndDate": {
    "date": "2027-01-01",
    "timezone": "America/New_York"
  },
  "policyEffectiveDate": {
    "date": "2026-01-01",
    "timezone": "America/New_York"
  },
  "policyType": "generalLiability",
  "policyTimeZone": "America/New_York",
  "primaryInsured": "550e8400-e29b-41d4-a716-446655440010",
  "exposures": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440010",
      "exposureName": "Acme Corporation",
      "exposureType": "business"
    }
  ]
}
'

201

success

{
  "id": "550e8400-e29b-41d4-a716-446655440001"
}

Authorizations

Authorization · string · header · required

API key authentication. Include your API key in the Authorization header.

Path Parameters

companyId · string<uuid> · required

Company identifier

Body

application/json

policyNumber · string · required

Unique policy number within the company.

policyStartDate · object · required

Policy term start date.

Show child attributes

policyEndDate · object · required

Policy term end date.

Show child attributes

policyType · string · required

Policy type — must be one of the option-set values configured for your company. Retrieve available values via GET /policies/configuration.

policyTimeZone · string · required

IANA timezone the policy operates in.

primaryInsured · string<uuid> · required

UUID of the primary exposure — must appear as an id in the exposures array and correspond to an existing exposure record.

exposures · object[] · required

Exposures on the policy. Each must reference an existing exposure record by id.

Show child attributes

policyEffectiveDate · object

Policy effective date (usually same as start date).

Show child attributes

Response

201

application/json

Policy created

id · string<uuid> · required

Newly created policy ID