Skip to main content
The Insured API allows you to manage insured entities (exposures) for your company. Insureds represent the individuals or organizations that are covered by insurance policies. Key Concepts:
  • Insureds are entities (individuals or organizations) covered by insurance policies
  • Each insured has a name and entityType that classify them
  • Insureds can be associated with policies and events
  • Deleting an insured performs a soft delete (the record is marked as deleted but retained)

API Endpoints


Insured Fields

FieldTypeRequiredDescription
namestringYesName of the insured
entityTypestringYesEntity type (e.g., “individual”, “organization”, “dealership”)

Permissions

Access to insureds requires the appropriate permissions based on your API key:
OperationRequired Permission
Create Insuredcompany.insured:create
Delete Insuredcompany.insured:delete

Example Create Request

{
  "name": "Acme Manufacturing GmbH",
  "entityType": "organization"
}

Example Create Response

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

Example Delete Response

{
  "id": "550e8400-e29b-41d4-a716-446655440002",
  "deleted": true
}