curl --request POST \
  --url https://app.aiinsurance.io/api/v1/external/companies/{companyId}/entities/event \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "eventType": "claim",
  "eventCoverageType": "professionalLiability",
  "eventExposures": [
    "0d35345d-1d51-4419-aa64-f133b92038fd"
  ]
}
'

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

Events

Create Event

Creates an Event 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 Event 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" }.

The required fields are eventType, eventCoverageType, and eventExposures (a join field whose values are exposure entity IDs). Option-set fields take the option const value, not its display title — e.g. eventCoverageType is generalLiability / professionalLiability. eventName, eventStatus, and eventReferenceId are calculated/auto-set and cannot be supplied in the request body.

Required permission: company.claim:create

POST

api

external

companies

{companyId}

entities

event

curl --request POST \
  --url https://app.aiinsurance.io/api/v1/external/companies/{companyId}/entities/event \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "eventType": "claim",
  "eventCoverageType": "professionalLiability",
  "eventExposures": [
    "0d35345d-1d51-4419-aa64-f133b92038fd"
  ]
}
'

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

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

Event created successfully

string<uuid>

The ID of the created entity

Overview List Events

⌘I