Create Quote

curl --request POST \
  --url https://app.aiinsurance.io/api/v1/external/companies/{companyId}/entities/quote \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "quoteSubmission": "550e8400-e29b-41d4-a716-446655440402",
  "quoteType": "quote"
}
'

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

Quotes

Create Quote

Creates a Quote via the unified entity CRUD pipeline.

The request body is a flat JSON object where keys are field referenceIds from the company’s field configuration. Use the Get Quote Configuration endpoint to discover available fields and which are required.

The pipeline validates the data (option sets, types, join cardinality), resolves calculated/auto-set values, enforces framework-required fields, inserts, then syncs join relationships. Date fields are objects: { "date": "YYYY-MM-DD", "timezone": "America/New_York" }.

quoteNumber is a resolver-populated calculated value — do not send it as an input. Link the quote to its submission via the quoteSubmission join field; other fields come from your configuration.

Required permission: company.policy:create

POST

api

external

companies

{companyId}

entities

quote

Create Quote

curl --request POST \
  --url https://app.aiinsurance.io/api/v1/external/companies/{companyId}/entities/quote \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "quoteSubmission": "550e8400-e29b-41d4-a716-446655440402",
  "quoteType": "quote"
}
'

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

Authorizations

Authorization

string

header

required

API key authentication. Send your raw API key as the Authorization header value with NO scheme prefix — Authorization: YOUR-API-KEY. Do NOT prefix it with Bearer or ApiKey, and do not use an X-API-Key header; those are not accepted.

Path Parameters

companyId

string<uuid>

required

Company identifier

Body

application/json

Flat JSON object with field referenceIds as keys

Response

Quote created successfully

string<uuid>

The ID of the created entity

Overview List Quotes

⌘I