Create Submission

curl --request POST \
  --url https://app.aiinsurance.io/api/v1/external/companies/{companyId}/entities/submission \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "submissionName": "Acme 2025 Renewal",
  "submissionType": "newBusiness"
}
'

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

Submissions

Create Submission

Creates a Submission 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 Submission 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, inserts, then syncs join relationships. Date fields are objects: { "date": "YYYY-MM-DD", "timezone": "America/New_York" }.

Note: the configuration required flag (e.g. on submissionType) is advisory — it is not enforced on create. A submission created without submissionType persists with submissionType: null.

submissionNumber is a resolver-populated calculated value — do not send it as an input; other fields come from your configuration.

Required permission: company.submission:create

POST

api

external

companies

{companyId}

entities

submission

Create Submission

curl --request POST \
  --url https://app.aiinsurance.io/api/v1/external/companies/{companyId}/entities/submission \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "submissionName": "Acme 2025 Renewal",
  "submissionType": "newBusiness"
}
'

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

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

Submission created successfully

string<uuid>

The ID of the created entity

Overview List Submissions

⌘I