Skip to main content
POST
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.
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

string
required
company, person, opportunity or a custom key.
string
Up to 200 characters. Ignored for a person.
object
Values by short field key. A hidden or read-only field answers 422 CRM_FORBIDDEN_FIELD.
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.
Relations as { "defKey": "person_company", "toId": "..." }.
string | null
An active internal person, or null for no owner. Default: the token owner.

Response

The created record, as in Get CRM record, with status 201.
Last modified on November 13, 2026