{ "error": { "code": "CRM_DUPLICATE_CONTACT_POINT", "message": "Another record already holds this address or domain.", "kind": "DOMAIN", "existingRecordId": "cm3rec0009" } }
{ "error": { "code": "CRM_FORBIDDEN_FIELD", "message": "A field in the request is hidden or read-only for your role" } }
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.
array
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.