Create a New CRM Entity crm.item.add

If you are developing integrations for Bitrix24 using AI tools (Codex, Claude Code, Cursor), connect to the MCP server so that the assistant can utilize the official REST documentation.

Scope: crm

Who can execute the method: any user with the "add" access permission for the CRM entity

This method is a universal approach for creating objects in CRM. It allows you to create various types of objects, such as deals, contacts, companies, and others.

To create an object, you need to pass the appropriate parameters, including the object type and its information: title, description, contact details, and other specifics.

Upon successful execution of the request, a new object is created.

This method provides a flexible opportunity to automate the process of creating objects and integrate CRM with other systems.

When creating an entity, a standard series of checks, modifications, and automatic actions are performed:

access permissions are checked
required fields are validated
dependent required fields based on stages are validated
field values are checked for correctness
default values are assigned to fields
automation rules are triggered after saving

Next, we will take a closer look at how to use this method and what parameters need to be passed.

Method Parameters

Required parameters are marked with *

Name `type`	Description
entityTypeId* `integer`	Identifier of the system or custom type whose element we want to create. Numeric values for system types (Lead — 1, Deal — 2, Contact — 3, Company — 4, Invoice — 31, etc.) are listed in the CRM object types reference. The identifier of the smart process can be obtained using the crm.type.list method.
fields* `object`	Object format. `{ field_1: value_1, field_2: value_2, ..., field_n: value_n, }` where `field_n` — field name `value_n` — field value Each CRM entity type has its own set of fields. This means that the set of fields for creating a Lead does not have to match the set of fields for creating a Contact or SPA. The list of available fields for each entity type is described below. An incorrect field in `fields` will be ignored.
useOriginalUfNames `boolean`	Parameter to control the format of custom field names in the request and response. Possible values: `Y` — original names of custom fields, e.g., `UF_CRM_2_1639669411830` `N` — custom field names in camelCase, e.g., `ufCrm2_1639669411830` Default is `N`

Parameter fields

Required parameters are marked with *

Lead

Deal

Contact

Company

Estimate

Invoice

Smart Process

CRM object identifier entityTypeId: 1

Name `type`	Description
title `string`	Title of the entity. By default, it is generated using the template `{entityTypeName} #{id}`, where `entityTypeName` — entity name `id` — entity identifier For example, for a lead with `id = 13` — 'Lead #13'
honorific `crm_status`	String identifier for the lead's address (e.g., `'HNR_RU_1' = 'Mr.'`). The list of available addresses can be obtained using `crm.status.list` with the filter `{ ENTITY_ID: "HONOFIRIC" }`. Default is `null`
name `string`	First name. Default is `null`
secondName `string`	Middle name. Default is `null`
lastName `string`	Last name. Default is `null`
birthdate `date`	Date of birth. Default is `null`
companyTitle `string`	Company name. Default is `null`
sourceId `crm_status`	String identifier for the source. For example, `'CALL' = 'Call'`. The list of available sources can be obtained using `crm.status.list` with the filter `{ ENTITY_ID: "SOURCE" }`. Default is the first available source
sourceDescription `text`	Additional information about the source. Default is `null`
stageId `crm_status`	String identifier for the stage of the entity. For example, `'NEW' = 'Unprocessed'`. The list of available stages can be obtained using `crm.status.list` with the filter `{ ENTITY_ID: "STATUS" }` Default is the first available stage
statusDescription `text`	Additional information about the stage. Default is `null`
post `string`	Position. Default is `null`
currencyId `crm_currency`	Identifier of the currency for the entity. Default is the default currency
isManualOpportunity `boolean`	Mode for calculating the amount. Possible values: `Y` — manual `N` — automatic Default is `N`
opportunity `double`	Amount. Default is `null`
opened `boolean`	Whether the entity is available to everyone. Possible values: `Y` — yes `N` — no Default is `Y`. The default value can be changed in the CRM settings
comments `text`	Comment. Default is `null`
assignedById `user`	Identifier of the user responsible for the entity. Default is the identifier of the user calling the method
companyId `crm_company`	Identifier of the company linked to the entity. The list of companies can be obtained using the `crm.item.list` method with `entityTypeId = 4`. Default is `null`
contactId `crm_contact`	Identifier of the contact linked to the entity. The list of contacts can be obtained using the `crm.item.list` method with `entityTypeId = 3`. Default is `null`
contactIds `crm_contact[]`	List of identifiers of contacts linked to the entity. The list of contacts can be obtained using the `crm.item.list` method with `entityTypeId = 3`. Default is `null`
originatorId `string`	External source. Default is `null`
originId `string`	Identifier of the entity in the external source. Default is `null`
webformId `integer`	Identifier of the CRM Form. Default is `null`
observers `user[]`	Array of identifiers of users who will be observers in the entity. Default is `null`
utmSource `string`	Advertising system. For example: Google Ads, Bing Ads, etc. Default is `null`
utmMedium `string`	Type of traffic. Possible values: CPC — ads CPM — banners Default is `null`
utmCampaign `string`	Identifier of the advertising campaign. Default is `null`
utmContent `string`	Content of the campaign. For example, for contextual ads. Default is `null`
utmTerm `string`	Search condition of the campaign. For example, keywords for contextual advertising. Default is `null`
ufCrm... `crm_userfield`	Custom field. Read about custom fields in the section Custom Fields in CRM: Overview of Methods Values of multiple fields are passed as an array. To upload a file, the value of the custom field must be an array where the first element is the file name and the second is the content of the file encoded in base64.
parentId... `crm_entity`	Parent field. An element of another type of CRM object that is linked to this element. Each such field has the code `parentId + {parentEntityTypeId}`
fm `multifield[]`	Array of multifields. More about multifields can be read in the section crm_multifield Structure of a multifield: `typeId` — Type of multifield `valueType` — Type of value `value` — Value Example: `fm: [ { "valueType": "WORK", "value": "+19999999999", "typeId": "PHONE" }, { "valueType": "WORK", "value": "example@example.com", "typeId": "EMAIL" } ]` Default is `null`

CRM object identifier entityTypeId: 2

Name `type`	Description
title `string`	Title of the entity. By default, it is generated using the template `{entityTypeName} #{id}`, where `entityTypeName` — entity name `id` — entity identifier For example, for a deal with `id = 13` => 'Deal #13'
typeId `crm_status`	String identifier for the entity type. For example, for a deal: `'SALE' = 'Sale'` The list of available entity types can be obtained using `crm.status.list` with the filter `{ ENTITY_ID: "DEAL_TYPE" }` Default is the first available entity type
categoryId `integer`	Identifier of the direction (funnel) of the deal. Default is `0` (general)
stageId `crm_status`	String identifier for the stage of the entity. For example, `'NEW' = 'Unprocessed'`. The list of available stages can be obtained using `crm.status.list` with the filter: If the deal is in the general funnel (direction) — `{ ENTITY_ID: "DEAL_STAGE" }` If the deal is not in the general funnel (direction) — `{ ENTITY_ID: "DEAL_STAGE_{categoryId}" }`, where `categoryId` is the identifier of the funnel (direction) of the deal Default is the first available stage relative to the funnel
isRecurring `boolean`	Whether the deal is recurring. Possible values: `Y` — yes `N` — no Default is `N`
probability `integer`	Probability %. Default is `null`
currencyId `crm_currency`	Identifier of the currency for the entity. Default is the default currency
isManualOpportunity `boolean`	Mode for calculating the amount. Possible values: `Y` — manual `N` — automatic Default is `N`
opportunity `double`	Amount. Default is `null`
taxValue `double`	Tax amount. Default is `null`
companyId `crm_company`	Identifier of the company linked to the entity. The list of companies can be obtained using the `crm.item.list` method with `entityTypeId = 4`. Default is `null`
contactId `crm_contact`	Identifier of the contact linked to the entity. The list of contacts can be obtained using the `crm.item.list` method with `entityTypeId = 3`. Default is `null`
contactIds `crm_contact[]`	List of identifiers of contacts linked to the entity. The list of contacts can be obtained using the `crm.item.list` method with `entityTypeId = 3`. Default is `null`
quoteId `crm_quote`	Identifier of the estimate that will be linked to the deal
begindate `date`	Start date of the entity. Default is the creation date
closedate `date`	End date of the entity. Default is the creation date of the entity + 7 days
opened `boolean`	Whether the entity is available to everyone. Possible values: `Y` — yes `N` — no Default is `Y`. The default value can be changed in the CRM settings
comments `text`	Comment. Default is `null`
assignedById `user`	Identifier of the user responsible for the entity. Default is the identifier of the user calling the method
sourceId `crm_status`	String identifier for the source. For example, `'CALL' = 'Call'`. The list of available sources can be obtained using `crm.status.list` with the filter `{ ENTITY_ID: "SOURCE" }`. Default is the first available source
sourceDescription `text`	Additional information about the source. Default is `null`
leadId `crm_lead`	Identifier of the lead based on which the entity is created. Default is `null`
additionalInfo `string`	Additional information. Default is `null`
originatorId `string`	External source. Default is `null`
originId `string`	Identifier of the entity in the external source. Default is `null`
observers `user[]`	Array of identifiers of users who will be observers in the entity. Default is `null`
locationId `location`	Identifier of the location. Service field. Default is `null`
utmSource `string`	Advertising system. Google Ads, Bing Ads, etc. Default is `null`
utmMedium `string`	Type of traffic. Possible values: CPC — ads CPM — banners Default is `null`
utmCampaign `string`	Identifier of the advertising campaign. Default is `null`
utmContent `string`	Content of the campaign. For example, for contextual ads. Default is `null`
utmTerm `string`	Search condition of the campaign. For example, keywords for contextual advertising. Default is `null`
ufCrm... `crm_userfield`	Custom field. See the section Custom Fields in CRM: Overview of Methods Values of multiple fields are passed as an array To upload a file, the value of the custom field must be an array where the first element is the file name, and the second is the content of the file encoded in base64.
parentId... `crm_entity`	Parent field. An element of another type of CRM object that is linked to this element. Each such field has the code `parentId + {parentEntityTypeId}`

CRM object identifier entityTypeId: 3

Name `type`	Description
honorific `crm_status`	String identifier for the contact's address. For example, `'HNR_RU_1' = 'Mr.'`. The list of available addresses can be obtained using `crm.status.list` with the filter `{ ENTITY_ID: "HONOFIRIC" }`. Default is `null`
name `string`	First name. Default is `null`
secondName `string`	Middle name. Default is `null`
lastName `string`	Last name. Default is `null`
photo `file`	Photo. Default is `null`
birthdate `date`	Date of birth. Default is `null`
typeId `crm_status`	String identifier for the entity type. For example, for a deal: `'SALE' = 'Sale'`. The list of available entity types can be obtained using `crm.status.list` with the filter `{ ENTITY_ID: "CONTACT_TYPE" }`. Default is the first available entity type
sourceId `crm_status`	String identifier for the source. For example, `'CALL' = 'Call'`. The list of available sources can be obtained using `crm.status.list` with the filter `{ ENTITY_ID: "SOURCE" }`. Default is the first available source
sourceDescription `text`	Additional information about the source. Default is `null`
post `string`	Position. Default is `null`
comments `text`	Comment. Default is `null`
opened `boolean`	Whether the entity is available to everyone. Possible values: `Y` — yes `N` — no Default is `Y`. The default value can be changed in the CRM settings
export `boolean`	Whether the contact is included in the export. Default is `Y`
assignedById `user`	Identifier of the user responsible for the entity. Default is the identifier of the user calling the method
companyId `crm_company`	Identifier of the company linked to the entity. The list of companies can be obtained using the `crm.item.list` method with `entityTypeId = 4`. Default is `null`
companyIds `crm_company`	Array of identifiers of companies that will be linked to the entity
leadId `crm_lead`	Identifier of the lead based on which the entity is created. Default is `null`
originatorId `string`	External source. Default is `null`
originId `string`	Identifier of the entity in the external source. Default is `null`
originVersion `string`	Version of the original. Default is `null`
observers `user[]`	Array of identifiers of users who will be observers in the entity. Default is `null`
utmSource `string`	Advertising system. Google Ads, Bing Ads, etc. Default is `null`
utmMedium `string`	Type of traffic. Possible values: CPC — ads CPM — banners Default is `null`
utmCampaign `string`	Identifier of the advertising campaign. Default is `null`
utmContent `string`	Content of the campaign. For example, for contextual ads. Default is `null`
utmTerm `string`	Search condition of the campaign. For example, keywords for contextual advertising. Default is `null`
ufCrm... `crm_userfield`	Custom field. See the section Custom Fields in CRM: Overview of Methods Values of multiple fields are passed as an array To upload a file, the value of the custom field must be an array where the first element is the file name, and the second is the content of the file encoded in base64.
parentId... `crm_entity`	Parent field. An element of another type of CRM object that is linked to this element. Each such field has the code `parentId + {parentEntityTypeId}`
fm `multifield[]`	Array of multifields. More about multifields can be read in the section crm_multifield Structure of a multifield: `typeId` — Type of multifield `valueType` — Type of value `value` — Value Example: `fm: [ { "valueType": "WORK", "value": "+19999999999", "typeId": "PHONE" }, { "valueType": "WORK", "value": "example@example.com", "typeId": "EMAIL" } ]` Default is `null`

CRM object identifier entityTypeId: 4

Name `type`	Description
title `string`	Title of the entity. By default, it is generated using the template `{entityTypeName} #{id}`, where `entityTypeName` — entity name `id` — entity identifier For example, for a company with `id = 13` => 'Company #13'
typeId `crm_status`	String identifier for the entity type. For example, for a deal: `'SALE' = 'Sale'`. The list of available entity types can be obtained using `crm.status.list` with the filter `{ ENTITY_ID: "COMPANY_TYPE" }`. Default is the first available entity type
logo `file`	Logo. Default is `null`
bankingDetails `string`	Banking details. Default is `null`
industry `crm_status`	String identifier for the industry type. For example, `'IT' = 'Information Technology'`. The list of available industry types can be obtained using the `crm.status.list` method with the filter `{ ENTITY_ID: "INDUSTRY"}`. Default is the first available industry type
employees `crm_status`	String identifier for the number of employees. The value is taken from the available list, for example, `'EMPLOYEES_1' = 'less than 50'`. The list of available employee counts can be obtained using the `crm.status.list` method with the filter `{ ENTITY_ID: "EMPLOYEES" }`. Default is the first available employee count
currencyId `crm_currency`	Identifier of the currency for the entity. Default is the default currency
revenue `double`	Annual revenue. Default is `0`
opened `boolean`	Whether the entity is available to everyone. Possible values: `Y` — yes `N` — no Default is `Y`. The default value can be changed in the CRM settings
comments `text`	Comment. Default is `null`
isMyCompany `boolean`	Whether the company is my company. Default is `N`
assignedById `user`	Identifier of the user responsible for the entity. Default is the identifier of the user calling the method
contactIds `crm_contact[]`	List of identifiers of contacts linked to the entity. The list of contacts can be obtained using the `crm.item.list` method with `entityTypeId = 3`. Default is `null`
leadId `crm_lead`	Identifier of the lead based on which the entity is created. Default is `null`
originatorId `string`	External source. Default is `null`
originId `string`	Identifier of the entity in the external source. Default is `null`
originVersion `string`	Version of the original. Default is `null`
observers `user[]`	Array of identifiers of users who will be observers in the entity. Default is `null`
utmSource `string`	Advertising system. Google Ads, Bing Ads, etc. Default is `null`
utmMedium `string`	Type of traffic. Possible values: CPC — ads CPM — banners Default is `null`
utmCampaign `string`	Identifier of the advertising campaign. Default is `null`
utmContent `string`	Content of the campaign. For example, for contextual ads. Default is `null`
utmTerm `string`	Search condition of the campaign. For example, keywords for contextual advertising. Default is `null`
ufCrm... `crm_userfield`	Custom field. See the section Custom Fields in CRM: Overview of Methods Values of multiple fields are passed as an array To upload a file, the value of the custom field must be an array where the first element is the file name, and the second is the content of the file encoded in base64
parentId... `crm_entity`	Parent field. An element of another type of CRM object that is linked to this element. Each such field has the code `parentId + {parentEntityTypeId}`
fm `multifield[]`	Array of multifields. More about multifields can be read in the section crm_multifield Structure of a multifield: `typeId` — Type of multifield `valueType` — Type of value `value` — Value Example: `fm: [ { "valueType": "WORK", "value": "+19999999999", "typeId": "PHONE" }, { "valueType": "WORK", "value": "example@example.com", "typeId": "EMAIL" } ]` Default is `null`

CRM object identifier entityTypeId: 7

Name `type`	Description
title `string`	Title of the entity. By default, it is generated using the template `{entityTypeName} #{id}`, where `entityTypeName` — entity name `id` — entity identifier For example, for an estimate with `id = 13` => 'Estimate #13'
assignedById `user`	Identifier of the user responsible for the entity. Default is the identifier of the user calling the method
opened `boolean`	Whether the entity is available to everyone. Possible values: `Y` — yes `N` — no Default is `Y`. The default value can be changed in the CRM settings
content `text`	Content. Default is `null`
terms `text`	Terms. Default is `null`
comments `text`	Comment. Default is `null`
dealId `crm_deal`	Identifier of the linked deal. Default is `null`
leadId `crm_lead`	Identifier of the lead based on which the entity is created. Default is `null`
storageTypeId `integer`	Identifier of the storage type. Possible values: `1` — file `2` — WebDAV `3` — Drive Default: If the `disk` module is enabled -> Drive If the `webdav` module is enabled -> WebDAV File
storageElementIds `integer`	Array of files. Default is `null`
webformId `integer`	Identifier of the CRM Form. Default is `null`
companyId `crm_company`	Identifier of the company linked to the entity. The list of companies can be obtained using the `crm.item.list` method with `entityTypeId = 4`. Default is `null`
contactId `crm_contact`	Identifier of the contact linked to the entity. The list of contacts can be obtained using the `crm.item.list` method with `entityTypeId = 3` Default is `null`
contactIds `crm_contact[]`	List of identifiers of contacts linked to the entity. The list of contacts can be obtained using the `crm.item.list` method with `entityTypeId = 3`. Default is `null`
locationId `location`	Identifier of the location. Service field. Default is `null`
currencyId `crm_currency`	Identifier of the currency for the entity. Default is the default currency
isManualOpportunity `boolean`	Mode for calculating the amount. `Y` — manual `N` — automatic Default is `N`
opportunity `double`	Amount. Default is `null`
taxValue `double`	Tax amount. Default is `null`
stageId `crm_status`	String identifier for the stage of the entity. For example, `'DRAFT' = 'New'`. The list of available stages can be obtained using `crm.status.list` with the filter `{ ENTITY_ID: "QUOTE_STATUS" }`. Default is the first available stage
begindate `date`	Start date of the entity. Default is the creation date of the entity
closedate `date`	End date of the entity. Default is the creation date of the entity + 7 days
actualDate `date`	Valid until. Default is the creation date of the entity + 7 days
mycompanyId `crm_company`	Identifier of my company. Default is the identifier of the first available "my" company
utmSource `string`	Advertising system. Google Ads, Bing Ads, etc. Default is `null`
utmMedium `string`	Type of traffic. CPC — ads CPM — banners Default is `null`
utmCampaign `string`	Identifier of the advertising campaign. Default is `null`
utmContent `string`	Content of the campaign. For example, for contextual ads. Default is `null`
utmTerm `string`	Search condition of the campaign. For example, keywords for contextual advertising. Default is `null`
ufCrm... `crm_userfield`	Custom field. See the section Custom Fields in CRM: Overview of Methods. Values of multiple fields are passed as an array To upload a file, the value of the custom field must be an array where the first element is the file name, and the second is the content of the file encoded in base64.
parentId... `crm_entity`	Parent field. An element of another type of CRM object that is linked to this element. Each such field has the code `parentId + {parentEntityTypeId}`

CRM object identifier entityTypeId: 31

Name `type`	Description
title `string`	Title of the entity. By default, it is generated using the template `{entityTypeName} #{id}`, where `entityTypeName` — entity name `id` — entity identifier For example, for an invoice with `id = 13` => 'Invoice #13'
xmlId `string`	External code. Default is `null`
assignedById `user`	Identifier of the user responsible for the entity. Default is the identifier of the user calling the method
opened `boolean`	Whether the entity is available to everyone. Possible values: `Y` — yes `N` — no Default is `Y`. The default value can be changed in the CRM settings
webformId `integer`	Identifier of the CRM Form. Default is `null`
begindate `date`	Start date of the entity. Default is the creation date of the entity
closedate `date`	End date of the entity. Default is the creation date of the entity + 7 days
companyId `crm_company`	Identifier of the company linked to the entity. The list of companies can be obtained using the `crm.item.list` method with `entityTypeId = 4`. Default is `null`
contactId `crm_contact`	Identifier of the contact linked to the entity. The list of contacts can be obtained using the `crm.item.list` method with `entityTypeId = 3`. Default is `null`
contactIds `crm_contact[]`	List of identifiers of contacts linked to the entity. The list of contacts can be obtained using the `crm.item.list` method with `entityTypeId = 3`. Default is `null`
observers `user[]`	Array of identifiers of users who will be observers in the entity. Default is `null`
stageId `crm_status`	String identifier for the stage of the entity. For example, `'DT31_13:N' = 'New'`. The list of available stages can be obtained using `crm.status.list`, with the filter: `{ ENTITY_ID: "SMART_INVOICE_STAGE_{categoryId}" }`, where `categoryId` is the identifier of the default invoice funnel. It can be obtained using `crm.category.list` with `entityTypeId = 31`. Default is the first available stage
sourceId `crm_status`	String identifier for the source. For example, `'CALL' = 'Call'`. The list of available sources can be obtained using `crm.status.list` with the filter `{ ENTITY_ID: "SOURCE" }`. Default is the first available source
sourceDescription `text`	Additional information about the source. Default is `null`
currencyId `crm_currency`	Identifier of the currency for the entity. Default is the default currency
isManualOpportunity `boolean`	Mode for calculating the amount. Possible values: `Y` — manual `N` — automatic Default is `N`
opportunity `double`	Amount. Default is `null`
taxValue `double`	Tax amount. Default is `null`
mycompanyId `crm_company`	Identifier of my company. Default is the identifier of the first available "my" company
comments `text`	Comment. Default is `null`
locationId `location`	Identifier of the location. Service field. Default is `null`
ufCrm... `crm_userfield`	Custom field. See the section Custom Fields in CRM: Overview of Methods. Values of multiple fields are passed as an array To upload a file, the value of the custom field must be an array where the first element is the file name, and the second is the content of the file encoded in base64.
parentId... `crm_entity`	Parent field. An element of another type of CRM object that is linked to this element. Each such field has the code `parentId + {parentEntityTypeId}`

CRM object identifier entityTypeId: can be obtained using the crm.type.list method or created using the crm.type.add method.

Name `type`	Description
title `string`	Title of the entity. By default, it is generated using the template `{entityTypeName} #{id}`, where `entityTypeName` — name of the smart process `id` — entity identifier For example, for the smart process "HR" with `id = 13` => 'HR #13'
xmlId `string`	External code. Default is `null`
assignedById `user`	Identifier of the user responsible for the entity. Default is the identifier of the user calling the method
opened `boolean`	Whether the entity is available to everyone. `Y` — yes `N` — no Default is `Y`. The default value can be changed in the CRM settings
webformId `integer`	Identifier of the CRM Form. Default is `null`
begindate `date`	Start date of the entity. Available only if the `isBeginCloseDatesEnabled` setting is enabled for the corresponding smart process. Default is the creation date of the entity
closedate `date`	End date of the entity. Available only if the `isBeginCloseDatesEnabled` setting is enabled for the corresponding smart process. Default is the creation date of the entity + 7 days
companyId `crm_company`	Identifier of the company linked to the entity. The list of companies can be obtained using the `crm.item.list` method with `entityTypeId = 4`. Available only if the `isClientEnabled` setting is enabled for the corresponding smart process. Default is `null`
contactId `crm_contact`	Identifier of the contact linked to the entity. The list of contacts can be obtained using the `crm.item.list` method with `entityTypeId = 3`. Available only if the `isClientEnabled` setting is enabled for the corresponding smart process. Default is `null`
contactIds `crm_contact[]`	List of identifiers of contacts linked to the entity. The list of contacts can be obtained using the `crm.item.list` method with `entityTypeId = 3`. Available only if the `isClientEnabled` setting is enabled for the corresponding smart process. Default is `null`
observers `user[]`	Array of identifiers of users who will be observers in the entity. Available only if the `isObserversEnabled` setting is enabled for the corresponding smart process. Default is `null`
categoryId `crm_category`	Identifier of the funnel of the smart process entity. The list of available funnels can be obtained using the `crm.category.list` with the corresponding `entityTypeId`
stageId `crm_status`	String identifier for the stage of the entity. For example, `'DT1220_30:NEW' = 'Start'`. The list of available stages can be obtained using `crm.status.list` with the filter `{ ENTITY_ID: "DYNAMIC_{entityTypeId}_STAGE_{categoryId}" }`, where `entityTypeId` — identifier of the smart process type `categoryId` — identifier of the funnel (direction) of the smart process entity More about funnels (directions). Available only if the `isStagesEnabled` setting is enabled for the corresponding smart process. Default is the first available stage relative to the funnel
sourceId `crm_status`	String identifier for the source. (for example, `'CALL' = 'Call'`). The list of available sources can be obtained using `crm.status.list` with the filter `{ ENTITY_ID: "SOURCE" }`. Available only if the `isSourceEnabled` setting is enabled for the corresponding smart process. Default is the first available source
sourceDescription `text`	Additional information about the source. Available only if the `isSourceEnabled` setting is enabled for the corresponding smart process. Default is `null`
currencyId `crm_currency`	Identifier of the currency for the entity. Available only if the `isLinkWithProductsEnabled` setting is enabled for the corresponding smart process. Default is the default currency
isManualOpportunity `boolean`	Mode for calculating the amount. Possible values: `Y` — manual `N` — automatic Available only if the `isLinkWithProductsEnabled` setting is enabled for the corresponding smart process. Default is `N`
opportunity `double`	Amount. Available only if the `isLinkWithProductsEnabled` setting is enabled for the corresponding smart process. Default is `null`
taxValue `double`	Tax amount. Available only if the `isLinkWithProductsEnabled` setting is enabled for the corresponding smart process. Default is `null`
mycompanyId `crm_company`	Identifier of my company. Available only if the `isMycompanyEnabled` setting is enabled for the corresponding smart process. Default is the identifier of the first available "my" company
ufCrm... `crm_userfield`	Custom field. See the section Custom Fields in CRM: Overview of Methods. Values of multiple fields are passed as an array To upload a file, the value of the custom field must be an array where the first element is the file name, and the second is the content of the file encoded in base64.
parentId... `crm_entity`	Parent field. An element of another type of CRM object that is linked to this element. Each such field has the code `parentId + {parentEntityTypeId}`

Smart Process Settings

You can read more about managing smart process settings in Smart Processes: Overview of Methods

Code Examples

How to Use Examples in Documentation

Example of creating a deal

cURL (Webhook)

cURL (OAuth)

PHP

PHP (B24PhpSdk)

curl -X POST \
        -H "Content-Type: application/json" \
        -H "Accept: application/json" \
        -d '{"entityTypeId":2,"fields":{"title":"New deal (specifically for the REST methods example)","typeId":"SERVICE","categoryId":9,"stageId":"C9:UC_KN8KFI","isReccurring":"Y","probability":50,"currencyId":"USD","isManualOpportunity":"Y","opportunity":999.99,"taxValue":99.9,"companyId":5,"contactId":4,"contactIds":[4,5],"quoteId":7,"begindate":"formatDate(monthAgo)","closedate":"formatDate(twelveDaysInAdvance)","opened":"N","comments":"commentsExample","assignedById":6,"sourceId":"WEB","sourceDescription":"There should be additional description about the source","leadId":102,"additionalInfo":"There should be additional information","observers":[2,3],"utmSource":"google","utmMedium":"CPC","ufCrm_1721244707107":1111.1,"parentId1220":2}}' \
        https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/crm.item.add

curl -X POST \
        -H "Content-Type: application/json" \
        -H "Accept: application/json" \
        -d '{"entityTypeId":2,"fields":{"title":"New deal (specifically for the REST methods example)","typeId":"SERVICE","categoryId":9,"stageId":"C9:UC_KN8KFI","isReccurring":"Y","probability":50,"currencyId":"USD","isManualOpportunity":"Y","opportunity":999.99,"taxValue":99.9,"companyId":5,"contactId":4,"contactIds":[4,5],"quoteId":7,"begindate":"formatDate(monthAgo)","closedate":"formatDate(twelveDaysInAdvance)","opened":"N","comments":"commentsExample","assignedById":6,"sourceId":"WEB","sourceDescription":"There should be additional description about the source","leadId":102,"additionalInfo":"There should be additional information","observers":[2,3],"utmSource":"google","utmMedium":"CPC","ufCrm_1721244707107":1111.1,"parentId1220":2},"auth":"**put_access_token_here**"}' \
        https://**put_your_bitrix24_address**/rest/crm.item.add

const formatDate = (date) => {
            return date.toISOString().slice(0, 10);
        };
        
        const day = 60 * 60 * 24 * 1000;
        
        const now = new Date();
        const twelveDaysInAdvance = new Date(now.getTime() + 12 * day);
        const monthAgo = new Date(now.getTime() - 30 * day);
        
        const commentsExample = `
        Example comment inside the deal
        
        [B]Bold text[/B]
        [I]Italic[/I]
        [U]Underlined[/U]
        [S]Strikethrough[/S]
        [B][I][U][S]Mix[/S][/U][/I][/B]
        
        [LIST]
        [*]List item #1
        [*]List item #2
        [*]List item #3
        [/LIST]
        
        [LIST=1]
        [*]Numbered list item #1
        [*]Numbered list item #2
        [*]Numbered list item #3
        [/LIST]
        `;
        
        BX24.callMethod(
            'crm.item.add', 
            {
                entityTypeId: 2,
                fields: 
                {
                    title: "New deal (specifically for the REST methods example)",
                    typeId: "SERVICE",
                    categoryId: 9,
                    stageId: "C9:UC_KN8KFI",
                    isReccurring: "Y",
                    probability: 50,
                    currencyId: "USD",
                    isManualOpportunity: "Y",
                    opportunity: 999.99,
                    taxValue: 99.9,
                    companyId: 5,
                    contactId: 4,
                    contactIds: [4, 5],
                    quoteId: 7,
                    begindate: formatDate(monthAgo),
                    closedate: formatDate(twelveDaysInAdvance),
                    opened: "N",
                    comments: commentsExample,
                    assignedById: 6,
                    sourceId: "WEB",
                    sourceDescription: "There should be additional description about the source",
                    leadId: 102,
                    additionalInfo: "There should be additional information",
                    observers: [2, 3],
                    utmSource: "google",
                    utmMedium: "CPC",
                    ufCrm_1721244707107: 1111.1,
                    parentId1220: 2,
                },
            },
            (result) => 
            {
                result.error() 
                    ? console.error(result.error()) 
                    : console.info(result.data())
                ;
            }
        );

require_once('crest.php');
        
        $result = CRest::call(
            'crm.item.add',
            [
                'entityTypeId' => 2,
                'fields' => [
                    'title' => "New deal (specifically for the REST methods example)",
                    'typeId' => "SERVICE",
                    'categoryId' => 9,
                    'stageId' => "C9:UC_KN8KFI",
                    'isReccurring' => "Y",
                    'probability' => 50,
                    'currencyId' => "USD",
                    'isManualOpportunity' => "Y",
                    'opportunity' => 999.99,
                    'taxValue' => 99.9,
                    'companyId' => 5,
                    'contactId' => 4,
                    'contactIds' => [4, 5],
                    'quoteId' => 7,
                    'begindate' => formatDate(monthAgo),
                    'closedate' => formatDate(twelveDaysInAdvance),
                    'opened' => "N",
                    'comments' => $commentsExample,
                    'assignedById' => 6,
                    'sourceId' => "WEB",
                    'sourceDescription' => "There should be additional description about the source",
                    'leadId' => 102,
                    'additionalInfo' => "There should be additional information",
                    'observers' => [2, 3],
                    'utmSource' => "google",
                    'utmMedium' => "CPC",
                    'ufCrm_1721244707107' => 1111.1,
                    'parentId1220' => 2,
                ],
            ]
        );
        
        echo '<PRE>';
        print_r($result);
        echo '</PRE>';

try {
           $entityTypeId = 1; // Example entity type ID
           $fields = [
               'title' => 'New Item',
               'createdTime' => (new DateTime())->format(DateTime::ATOM),
               'updatedTime' => (new DateTime())->format(DateTime::ATOM),
               'begindate' => (new DateTime())->format(DateTime::ATOM),
               'closedate' => (new DateTime())->format(DateTime::ATOM),
               // Add other necessary fields as required
           ];
        
           $result = $serviceBuilder
               ->getCRMScope()
               ->item()
               ->add($entityTypeId, $fields);
        
           print("ID: " . $result->item()->id . PHP_EOL);
           print("Title: " . $result->item()->title . PHP_EOL);
           print("Created By: " . $result->item()->createdBy . PHP_EOL);
           print("Updated By: " . $result->item()->updatedBy . PHP_EOL);
           print("Created Time: " . $result->item()->createdTime->format(DateTime::ATOM) . PHP_EOL);
           print("Updated Time: " . $result->item()->updatedTime->format(DateTime::ATOM) . PHP_EOL);
        } catch (Throwable $e) {
           print("Error: " . $e->getMessage() . PHP_EOL);
        }

Example of creating an SPA item with a set of custom fields

Custom fields involved in the example

{
        "ufCrm44_1721812760630": {
            "type": "string",
            "isRequired": false,
            "isReadOnly": false,
            "isImmutable": false,
            "isMultiple": false,
            "isDynamic": true,
            "title": "Custom field (string)",
            "listLabel": "Custom field (string)",
            "formLabel": "Custom field (string)",
            "filterLabel": "Custom field (string)",
            "settings": {
            "SIZE": 20,
            "ROWS": 1,
            "REGEXP": "",
            "MIN_LENGTH": 0,
            "MAX_LENGTH": 0,
            "DEFAULT_VALUE": ""
            },
            "upperName": "UF_CRM_44_1721812760630"
        },
        "ufCrm44_1721812814433": {
            "type": "enumeration",
            "isRequired": false,
            "isReadOnly": false,
            "isImmutable": false,
            "isMultiple": false,
            "isDynamic": true,
            "items": [
            {
                "ID": "79",
                "VALUE": "List item #1"
            },
            {
                "ID": "80",
                "VALUE": "List item #2"
            },
            {
                "ID": "81",
                "VALUE": "List item #3"
            },
            {
                "ID": "82",
                "VALUE": "List item #4"
            }
            ],
            "title": "Custom field (list)",
            "listLabel": "Custom field (list)",
            "formLabel": "Custom field (list)",
            "filterLabel": "Custom field (list)",
            "settings": {
            "DISPLAY": "LIST",
            "LIST_HEIGHT": 1,
            "CAPTION_NO_VALUE": "",
            "SHOW_NO_VALUE": "Y"
            },
            "upperName": "UF_CRM_44_1721812814433"
        },
        "ufCrm44_1721812853419": {
            "type": "date",
            "isRequired": false,
            "isReadOnly": false,
            "isImmutable": false,
            "isMultiple": false,
            "isDynamic": true,
            "title": "Custom field (date)",
            "listLabel": "Custom field (date)",
            "formLabel": "Custom field (date)",
            "filterLabel": "Custom field (date)",
            "settings": {
            "DEFAULT_VALUE": {
                "TYPE": "NONE",
                "VALUE": ""
            }
            },
            "upperName": "UF_CRM_44_1721812853419"
        },
        "ufCrm44_1721812885588": {
            "type": "url",
            "isRequired": false,
            "isReadOnly": false,
            "isImmutable": false,
            "isMultiple": true,
            "isDynamic": true,
            "title": "Multiple custom field (link)",
            "listLabel": "Multiple custom field (link)",
            "formLabel": "Multiple custom field (link)",
            "filterLabel": "Multiple custom field (link)",
            "settings": {
            "POPUP": "Y",
            "SIZE": 20,
            "MIN_LENGTH": 0,
            "MAX_LENGTH": 0,
            "DEFAULT_VALUE": "",
            "ROWS": 1
            },
            "upperName": "UF_CRM_44_1721812885588"
        },
        "ufCrm44_1721812898903": {
            "type": "file",
            "isRequired": false,
            "isReadOnly": false,
            "isImmutable": false,
            "isMultiple": false,
            "isDynamic": true,
            "title": "Custom field (file)",
            "listLabel": "Custom field (file)",
            "formLabel": "Custom field (file)",
            "filterLabel": "Custom field (file)",
            "settings": {
            "SIZE": 20,
            "LIST_WIDTH": 0,
            "LIST_HEIGHT": 0,
            "MAX_SHOW_SIZE": 0,
            "MAX_ALLOWED_SIZE": 0,
            "EXTENSIONS": [],
            "TARGET_BLANK": "Y"
            },
            "upperName": "UF_CRM_44_1721812898903"
        },
        "ufCrm44_1721812915476": {
            "type": "money",
            "isRequired": false,
            "isReadOnly": false,
            "isImmutable": false,
            "isMultiple": false,
            "isDynamic": true,
            "title": "Custom field (money)",
            "listLabel": "Custom field (money)",
            "formLabel": "Custom field (money)",
            "filterLabel": "Custom field (money)",
            "settings": {
            "DEFAULT_VALUE": ""
            },
            "upperName": "UF_CRM_44_1721812915476"
        },
        "ufCrm44_1721812935209": {
            "type": "boolean",
            "isRequired": false,
            "isReadOnly": false,
            "isImmutable": false,
            "isMultiple": false,
            "isDynamic": true,
            "title": "Custom field (Yes/No)",
            "listLabel": "Custom field (Yes/No)",
            "formLabel": "Custom field (Yes/No)",
            "filterLabel": "Custom field (Yes/No)",
            "settings": {
            "DEFAULT_VALUE": 0,
            "DISPLAY": "CHECKBOX",
            "LABEL": [
                "",
                ""
            ],
            "LABEL_CHECKBOX": {
                "en": "Custom field (Yes/No)",
                "de": "Custom field (Yes/No)",
                "th": "Custom field (Yes/No)",
                "la": "Custom field (Yes/No)",
                "tc": "Custom field (Yes/No)",
                "sc": "Custom field (Yes/No)",
                "br": "Custom field (Yes/No)",
                "ar": "Custom field (Yes/No)",
                "fr": "Custom field (Yes/No)",
                "vn": "Custom field (Yes/No)",
                "pl": "Custom field (Yes/No)",
                "tr": "Custom field (Yes/No)",
                "ja": "Custom field (Yes/No)",
                "it": "Custom field (Yes/No)",
                "ms": "Custom field (Yes/No)",
                "id": "Custom field (Yes/No)"
            }
            },
            "upperName": "UF_CRM_44_1721812935209"
        },
        "ufCrm44_1721812948498": {
            "type": "double",
            "isRequired": false,
            "isReadOnly": false,
            "isImmutable": false,
            "isMultiple": false,
            "isDynamic": true,
            "title": "Custom field (number)",
            "listLabel": "Custom field (number)",
            "formLabel": "Custom field (number)",
            "filterLabel": "Custom field (number)",
            "settings": {
            "PRECISION": 2,
            "SIZE": 20,
            "MIN_VALUE": 0,
            "MAX_VALUE": 0,
            "DEFAULT_VALUE": null
            },
            "upperName": "UF_CRM_44_1721812948498"
        }
        }

cURL (Webhook)

cURL (OAuth)

PHP

curl -X POST \
        -H "Content-Type: application/json" \
        -H "Accept: application/json" \
        -d '{
            "entityTypeId": 1302,
            "fields": {
                "ufCrm44_1721812760630": "String for custom field of type String",
                "ufCrm44_1721812814433": 81,
                "ufCrm44_1721812853419": "'"$(date '+%Y-%m-%d')"'",
                "ufCrm44_1721812885588": [
                    "example.com",
                    "second-example.com"
                ],
                "ufCrm44_1721812898903": [
                    "green_pixel.png",
                    "iVBORw0KGgoAAAANSUhEUgAAAIAAAAAMCAYAAACqTLVoAAAALklEQVR42u3SAQEAAAQDsEsuOj3YMqwy6fBWCSCAAAIgAAIgAAIgAAIgAAJw3QLOrRH1U/gU4gAAAABJRU5ErkJggg=="
                ],
                "ufCrm44_1721812915476": "300|USD",
                "ufCrm44_1721812935209": "Y",
                "ufCrm44_1721812948498": 9999.9
            }
        }' \
        https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/crm.item.add

curl -X POST \
        -H "Content-Type: application/json" \
        -H "Accept: application/json" \
        -d '{
            "entityTypeId": 1302,
            "fields": {
                "ufCrm44_1721812760630": "String for custom field of type String",
                "ufCrm44_1721812814433": 81,
                "ufCrm44_1721812853419": "'"$(date '+%Y-%m-%d')"'",
                "ufCrm44_1721812885588": [
                    "example.com",
                    "second-example.com"
                ],
                "ufCrm44_1721812898903": [
                    "green_pixel.png",
                    "iVBORw0KGgoAAAANSUhEUgAAAIAAAAAMCAYAAACqTLVoAAAALklEQVR42u3SAQEAAAQDsEsuOj3YMqwy6fBWCSCAAAIgAAIgAAIgAAIgAAJw3QLOrRH1U/gU4gAAAABJRU5ErkJggg=="
                ],
                "ufCrm44_1721812915476": "300|USD",
                "ufCrm44_1721812935209": "Y",
                "ufCrm44_1721812948498": 9999.9
            },
            "auth": "**put_access_token_here**"
        }' \
        https://**put_your_bitrix24_address**/rest/crm.item.add

const greenPixelInBase64 = "iVBORw0KGgoAAAANSUhEUgAAAIAAAAAMCAYAAACqTLVoAAAALklEQVR42u3SAQEAAAQDsEsuOj3YMqwy6fBWCSCAAAIgAAIgAAIgAAIgAAJw3QLOrRH1U/gU4gAAAABJRU5ErkJggg==";
        
        BX24.callMethod(
            'crm.item.add', 
            {
                entityTypeId: 1302,
                fields: {
                    ufCrm44_1721812760630: "String for custom field of type String",
                    ufCrm44_1721812814433: 81,
                    ufCrm44_1721812853419: (new Date()).toISOString().slice(0, 10),
                    ufCrm44_1721812885588: [
                        "example.com",
                        "second-example.com",
                    ],
                    ufCrm44_1721812898903: [
                        "green_pixel.png",
                        greenPixelInBase64,
                    ],
                    ufCrm44_1721812915476: "300|USD",
                    ufCrm44_1721812935209: "Y",
                    ufCrm44_1721812948498: 9999.9,
                },
            },
            (result) => 
            {
                result.error() 
                    ? console.error(result.error()) 
                    : console.info(result.data())
                ;
            }
        );

require_once('crest.php');
        
        $result = CRest::call(
            'crm.item.add',
            [
                'entityTypeId' => 1302,
                'fields' => [
                    'ufCrm44_1721812760630' => "String for custom field of type String",
                    'ufCrm44_1721812814433' => 81,
                    'ufCrm44_1721812853419' => date('Y-m-d'),
                    'ufCrm44_1721812885588' => [
                        "example.com",
                        "second-example.com",
                    ],
                    'ufCrm44_1721812898903' => [
                        "green_pixel.png",
                        "iVBORw0KGgoAAAANSUhEUgAAAIAAAAAMCAYAAACqTLVoAAAALklEQVR42u3SAQEAAAQDsEsuOj3YMqwy6fBWCSCAAAIgAAIgAAIgAAIgAAJw3QLOrRH1U/gU4gAAAABJRU5ErkJggg==",
                    ],
                    'ufCrm44_1721812915476' => "300|USD",
                    'ufCrm44_1721812935209' => "Y",
                    'ufCrm44_1721812948498' => 9999.9,
                ],
            ]
        );
        
        echo '<PRE>';
        print_r($result);
        echo '</PRE>';

Response Handling

HTTP Status: 200

Note

Disabled fields always return null.

{
            "result": {
                "item": {
                    "id": 342,
                    "createdTime": "2024-07-18T14:00:14+02:00",
                    "dateCreateShort": null,
                    "updatedTime": "2024-07-18T14:00:14+02:00",
                    "dateModifyShort": null,
                    "createdBy": 1,
                    "updatedBy": 1,
                    "assignedById": 6,
                    "opened": "N",
                    "leadId": 102,
                    "companyId": 5,
                    "contactId": 4,
                    "quoteId": 7,
                    "title": "New deal (specifically for the REST methods example)",
                    "productId": null,
                    "categoryId": 9,
                    "stageId": "C9:UC_KN8KFI",
                    "stageSemanticId": "P",
                    "isNew": "N",
                    "isRecurring": "N",
                    "isReturnCustomer": "N",
                    "isRepeatedApproach": "Y",
                    "closed": "N",
                    "typeId": "SERVICE",
                    "opportunity": 999.99,
                    "isManualOpportunity": "Y",
                    "taxValue": 0,
                    "currencyId": "USD",
                    "probability": 50,
                    "comments": "\nExample comment inside the deal\n\n[B]Bold text[/B]\n[I]Italic[/I]\n[U]Underlined[/U]\n[S]Strikethrough[/S]\n[B][I][U][S]Mix[/S][/U][/I][/B]\n\n[LIST]\n[*]List item #1\n[*]List item #2\n[*]List item #3\n[/LIST]\n\n[LIST=1]\n[*]Numbered list item #1\n[*]Numbered list item #2\n[*]Numbered list item #3\n[/LIST]\n",
                    "begindate": "2024-06-18T02:00:00+02:00",
                    "begindateShort": null,
                    "closedate": "2024-07-30T02:00:00+02:00",
                    "closedateShort": null,
                    "eventDate": null,
                    "eventDateShort": null,
                    "eventId": null,
                    "eventDescription": null,
                    "locationId": null,
                    "webformId": null,
                    "sourceId": "WEB",
                    "sourceDescription": "There should be additional description about the source",
                    "originatorId": null,
                    "originId": null,
                    "additionalInfo": "There should be additional information",
                    "searchContent": null,
                    "orderStage": null,
                    "movedBy": 1,
                    "movedTime": "2024-07-18T14:00:14+02:00",
                    "lastActivityBy": 1,
                    "lastActivityTime": "2024-07-18T14:00:14+02:00",
                    "isWork": null,
                    "isWon": null,
                    "isLose": null,
                    "receivedAmount": null,
                    "lostAmount": null,
                    "hasProducts": null,
                    "ufCrm_1721244707107": 1111.1,
                    "parentId1220": 2,
                    "utmSource": "google",
                    "utmMedium": "CPC",
                    "utmCampaign": null,
                    "utmContent": null,
                    "utmTerm": null,
                    "observers": [
                        2,
                        3
                    ],
                    "contactIds": [
                        4,
                        5
                    ],
                    "entityTypeId": 2
                }
            },
            "time": {
                "start": 1721304013.245896,
                "finish": 1721304015.555471,
                "duration": 2.309574842453003,
                "processing": 1.8328988552093506,
                "date_start": "2024-07-18T14:00:13+02:00",
                "date_finish": "2024-07-18T14:00:15+02:00",
                "operating": 1.8328571319580078
            }
        }

By default, custom field names are passed and returned in camelCase, for example ufCrm2_1639669411830.
When passing the parameter useOriginalUfNames with the value Y, custom fields will be returned with their original names, for example UF_CRM_2_1639669411830.

Returned Data

Name `type`	Description
result `object`	Root element of the response, contains a single key `item`
item `item`	Information about the created item, field description
time `time`	Information about the request execution time

Error Handling

HTTP Status: 400, 403

{
            "error": "NOT_FOUND",
            "error_description": "Smart process not found"
        }

Name `type`	Description
error `string`	String error code. It may consist of digits, Latin letters, and underscores
error_description `error_description`	Textual description of the error. The description is not intended to be shown to the end user in its raw form

Possible Error Codes

Status	Code	Description	Value
`403`	`allowed_only_intranet_user`	Action allowed only for intranet users	User is not an intranet user
`400`	`NOT_FOUND`	Smart process not found	Occurs when an invalid `entityTypeId` is passed
`400`	`ACCESS_DENIED`	Access denied	User does not have permission to add items of type `entityTypeId`
`400`	`CRM_FIELD_ERROR_VALUE_NOT_VALID`	Invalid value for field "`field`"	Incorrect value passed for field `field`
`400`	`100`	Expected iterable value for multiple field, but got `type` instead	One of the multiple fields received a value of type `type`, while an iterable type was expected
`400`	`CREATE_DYNAMIC_ITEM_RESTRICTED`	You cannot create a new item due to your plan restrictions	Plan restrictions do not allow creating SPA items

Statuses and System Error Codes

HTTP Status: 20x, 40x, 50x

The errors described below may occur when calling any method.

Status	Code Error Message	Description
`500`	`INTERNAL_SERVER_ERROR` Internal server error	An internal server error has occurred. Please contact the server administrator or Bitrix24 technical support
`500`	`ERROR_UNEXPECTED_ANSWER` Server returned an unexpected response	An internal server error has occurred. Please contact the server administrator or Bitrix24 technical support
`503`	`QUERY_LIMIT_EXCEEDED` Too many requests	The request intensity limit has been exceeded
`405`	`ERROR_BATCH_METHOD_NOT_ALLOWED` Method is not allowed for batch usage	The current method is not permitted for calls using batch
`400`	`ERROR_BATCH_LENGTH_EXCEEDED` Max batch length exceeded	The maximum length of parameters passed to the batch method has been exceeded
`401`	`NO_AUTH_FOUND` Wrong authorization data	Invalid access token or webhook code
`400`	`INVALID_REQUEST` Https required	The HTTPS protocol is required for method calls
`503`	`OVERLOAD_LIMIT` REST API is blocked due to overload	The REST API is blocked due to overload. This is a manual individual block; please contact Bitrix24 technical support to lift it
`403`	`ACCESS_DENIED` REST API is available only on commercial plans	The REST API is only available on commercial plans
`403`	`INVALID_CREDENTIALS` Invalid request credentials	The user associated with the access token or webhook used to call the method lacks the necessary permissions
`404`	`ERROR_MANIFEST_IS_NOT_AVAILABLE` Manifest is not available	The manifest is not available
`403`	`insufficient_scope` The request requires higher privileges than provided by the webhook token	The request requires higher privileges than those provided by the webhook token
`401`	`expired_token` The access token provided has expired	The provided access token has expired
`403`	`user_access_error` The user does not have access to the application	The user does not have access to the application. This means that the application is installed, but the portal administrator has restricted access to this application to specific users only
`500`	`PORTAL_DELETED` Portal was deleted	The public part of the site is closed. To open the public part of the site on an on-premise installation, disable the "Temporary closure of the public part of the site" option. Path to the setting: Desktop > Settings > Product Settings > Module Settings > Main Module > Temporary closure of the public part of the site

Continue Learning

Get fields of custom type

Update Entity

Create a New CRM Entity crm.item.add

Method ParametersMethod Parameters

Parameter fieldsParameter fields

Code ExamplesCode Examples

Response HandlingResponse Handling

Returned DataReturned Data

Error HandlingError Handling

Possible Error CodesPossible Error Codes

Statuses and System Error CodesStatuses and System Error Codes

Continue LearningContinue Learning