Create an organization

Create an organization before referencing it in an imported conversation:

POST /api/v1/cxm/tenants/{tenantId}/organizations

Use a tenant API key with cxm:organizations.write or a broader scope. See the API overview for authentication and common limits.

Send a request

curl --request POST \
  --url "https://platform.crescendo.ai/api/v1/cxm/tenants/tenant_demo/organizations" \
  --header "Authorization: Bearer $CXP_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "organization": {
      "organizationId": "external-org-123",
      "name": "Example Ltd"
    }
  }'

name is required, trimmed and nonblank, with a maximum of 255 characters. organizationId is optional; omitting it generates an org_<uuid> ID. A supplied ID must be nonblank and at most 255 characters. It cannot contain whitespace, control characters, /, \, %, ? or #, and cannot equal . or ... The exact ID org_<tenantId> is reserved for tenant settings. The endpoint accepts only organizationId and name. It does not accept tags, website, custom fields, historical timestamps or contact associations.

Save the created ID

A successful request returns 201 Created:

{
  "organization": {
    "organizationId": "external-org-123",
    "result": "created"
  }
}

Duplicate names are allowed. A name is a display value, not a unique identity; CXP does not match or update an organization by name through this endpoint. For repeatable imports, preserve source IDs or save the returned ID mapping. An existing ID returns 409 OrganizationIdConflict with existingOrganizationId. This does not establish that the existing record has the same name or came from an earlier identical request. See common errors and retry behavior.

API guides

API reference

Create an organization

Create an organization

Send a request

Save the created ID

​Create an organization

​Send a request

​Save the created ID

Create an organization

Send a request

Save the created ID