Create Organization

curl --request POST \
  --url https://app.aiinsurance.io/api/v1/external/companies/{companyId}/entities/organization \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "Acme Corp",
  "type": "lawFirm",
  "email": "contact@acme.com"
}
'

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

Organizations

Create Organization

Creates an Organization 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. Organization has no dedicated /configuration endpoint — use the Configuration Management endpoints 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" }.

Required permission: company.fmv1_custom_object:create

POST

api

external

companies

{companyId}

entities

organization

Create Organization

curl --request POST \
  --url https://app.aiinsurance.io/api/v1/external/companies/{companyId}/entities/organization \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "Acme Corp",
  "type": "lawFirm",
  "email": "contact@acme.com"
}
'

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

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

Organization created successfully

string<uuid>

The ID of the created entity

Overview List Organizations

⌘I