> ## Documentation Index
> Fetch the complete documentation index at: https://collabase.ch/docs/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Collabase documentation. Interface labels are quoted in English, as they appear in the product.
> Features marked Enterprise need the Collabase Enterprise Edition licence.

# Create CRM record

> Create a company, a person, an opportunity or a record of a custom type; a domain or e-mail address that exists answers 409.

Creates a record. The owner is the token owner unless the request names another one. A person's
title is built from the first and last name, or from the first e-mail address. A company, an
opportunity and a record of a custom type need a `title`.

> [!NOTE]
>
> Scope `crm:write`. The token owner needs the right to create the type. Recorded in the audit log with the token's name.

## Request body

**typeKey** `string` *required*

`company`, `person`, `opportunity` or a custom key.

**title** `string`

Up to 200 characters. Ignored for a person.

**fields** `object`

Values by short field key. A hidden or read-only field answers `422 CRM_FORBIDDEN_FIELD`.

**contactPoints** `array`

`kind` (`EMAIL`, `PHONE`, `DOMAIN`), `value`, optional `label` and `isPrimary`. At most 20 per kind. Addresses and domains are normalised; one record holds an address or domain at a time.

**links** `array`

Relations as `{ "defKey": "person_company", "toId": "..." }`.

**ownerId** `string | null`

An active internal person, or `null` for no owner. Default: the token owner.

## Response

The created record, as in [Get CRM record](https://collabase.ch/docs/api/crm/get-record.md), with status `201`.

```bash cURL theme={"dark"}
curl -X POST "https://your-collabase.ch/api/v1/crm/records" \
  -H "Authorization: Bearer cb_xYz123ABCD..." \
  -H "Content-Type: application/json" \
  -d '{
    "typeKey": "company",
    "title": "Beispiel AG",
    "fields": { "annualRevenue": 1200000 },
    "contactPoints": [{ "kind": "DOMAIN", "value": "beispiel.example", "isPrimary": true }]
  }'
```

```json 201 theme={"dark"}
{ "data": { "id": "cm3rec0001", "typeKey": "company", "title": "Beispiel AG", "contentUpdatedAt": "2026-11-02T09:30:00.000Z" } }
```

```json 409 theme={"dark"}
{ "error": { "code": "CRM_DUPLICATE_CONTACT_POINT", "message": "Another record already holds this address or domain.", "kind": "DOMAIN", "existingRecordId": "cm3rec0009" } }
```

```json 422 theme={"dark"}
{ "error": { "code": "CRM_FORBIDDEN_FIELD", "message": "A field in the request is hidden or read-only for your role" } }
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.