Create Submission

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

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

Submissions

Create Submission

Creates a new Field Model V1 submission.

The request body is a flat JSON object where keys are field referenceIds defined in the company’s field configuration. Use the Configuration endpoint to discover available fields.

Required field: submissionType must be provided.

Lifecycle fields (submissionStatus, submissionNumber, submissionName, submissionPrimaryInsured, submissionBoundDate, submissionQuotes) are system-managed. submissionStatus defaults to inProgress if not provided.

Required permission: company.submission:create

POST

api

external

companies

{companyId}

submissions

Create Submission

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

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

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

Submission field data (keys are field referenceIds)

Response

Submission created

string<uuid>

required

Newly created submission ID

List Submissions Get Submission

⌘I