Создать новый элемент CRM crm.item.add

Scope: crm

Кто может выполнять метод: любой пользователь с правом «добавления» элемента объекта CRM

Метод является универсальным методом для создания объектов в CRM. С помощью него вы можете создавать различные типы объектов, такие как сделки, контакты, компании и другие.

Для создания объекта необходимо передать соответствующие параметры, включая тип объекта и информацию о нем: название, описание, контактные данные и другие детали.

После успешного выполнения запроса создается новый объект.

Этот метод предоставляет гибкую возможность автоматизировать процесс создания объектов и интегрировать CRM с другими системами.

При создании элемента производится стандартный ряд проверок, модификаций и автоматических действий:

• проверяются права доступа
• проверяется заполненность обязательных полей
• проверяется заполненность зависимых от стадий обязательных полей
• проверяется корректность заполнения полей
• полям присваиваются значения по умолчанию
• после сохранения запускаются роботы

Далее рассмотрим подробнее, как использовать этот метод и какие параметры нужно передать.

Параметры методаПараметры метода

Обязательные параметры отмечены *

{
    field_1: value_1,
    field_2: value_2,
    ...,
    field_n: value_n,
}

Параметр fieldsПараметр fields

Обязательные параметры отмечены *

fm: [
  {
    "valueType": "WORK",
    "value": "+79999999",
    "typeId": "PHONE"
  },
  {
    "valueType": "WORK",
    "value": "bitrix@bitrix.ru",
    "typeId": "EMAIL"
  }
]

fm: [
  {
    "valueType": "WORK",
    "value": "+79999999",
    "typeId": "PHONE"
  },
  {
    "valueType": "WORK",
    "value": "bitrix@bitrix.ru",
    "typeId": "EMAIL"
  }
]

fm: [
  {
    "valueType": "WORK",
    "value": "+79999999",
    "typeId": "PHONE"
  },
  {
    "valueType": "WORK",
    "value": "bitrix@bitrix.ru",
    "typeId": "EMAIL"
  }
]

Примеры кодаПримеры кода

Как использовать примеры в документации

1. Пример создания сделки

   cURL (Webhook)

   cURL (OAuth)

   JS (TS)

   JS (UMD)

   Python

   PHP CRest

   PHP

   Go

   curl -X POST \
   -H "Content-Type: application/json" \
   -H "Accept: application/json" \
   -d '{"entityTypeId":2,"fields":{"title":"Новая сделка (специально для примера REST методов)","typeId":"SERVICE","categoryId":9,"stageId":"C9:UC_KN8KFI","isReccurring":"Y","probability":50,"currencyId":"RUB","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":"Тут должно быть дополнительное описание об источнике","leadId":102,"additionalInfo":"Тут должна быть дополнительная информация","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":"Новая сделка (специально для примера REST методов)","typeId":"SERVICE","categoryId":9,"stageId":"C9:UC_KN8KFI","isReccurring":"Y","probability":50,"currencyId":"RUB","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":"Тут должно быть дополнительное описание об источнике","leadId":102,"additionalInfo":"Тут должна быть дополнительная информация","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
   

   // This snippet is an ES module: top-level await requires type="module" or a bundler.
   // $b24 is an already-initialized SDK instance (see the SDK "Get started" guide).
   import { Text } from '@bitrix24/b24jssdk'
   import type { B24Frame } from '@bitrix24/b24jssdk'
   
   declare const $b24: B24Frame
   
   type CrmItem = {
     id: number
     title: string
   }
   
   // Shape of the payload returned in result (match the "response handling" section of the page)
   type ItemAddResult = {
     item: CrmItem
   }
   
   const formatDate = (date: Date): string => 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 a 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]',
   ].join('\n')
   
   try {
     const response = await $b24.actions.v2.call.make<ItemAddResult>({
       method: 'crm.item.add',
       params: {
         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: 'RUB',
           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: 'Additional description about the source goes here',
           leadId: 102,
           additionalInfo: 'Additional information goes here',
           observers: [2, 3],
           utmSource: 'google',
           utmMedium: 'CPC',
           ufCrm_1721244707107: 1111.1,
           parentId1220: 2,
         },
       },
       requestId: Text.getUuidRfc4122()
     })
   
     // The payload is available only on a successful response
     if (!response.isSuccess) {
       console.error(response.getErrorMessages().join('; '))
     } else {
       const result = response.getData()!.result
       console.info(`Created item #${result.item.id} (${result.item.title})`)
     }
   } catch (error) {
     // Thrown on transport or SDK failures (AjaxError, SdkError, etc.)
     console.error(error)
   }
   

   <!-- Load the SDK (UMD build); it is exposed as the global B24Js -->
   <script src="https://unpkg.com/@bitrix24/b24jssdk@1/dist/umd/index.min.js"></script>
   <script>
     async function addCrmItem() {
       try {
         // Initialize the SDK inside a Bitrix24 frame
         const $b24 = await B24Js.initializeB24Frame()
   
         const formatDate = (date) => 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 a 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]',
         ].join('\n')
   
         const response = await $b24.actions.v2.call.make({
           method: 'crm.item.add',
           params: {
             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: 'RUB',
               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: 'Additional description about the source goes here',
               leadId: 102,
               additionalInfo: 'Additional information goes here',
               observers: [2, 3],
               utmSource: 'google',
               utmMedium: 'CPC',
               ufCrm_1721244707107: 1111.1,
               parentId1220: 2,
             },
           },
           requestId: B24Js.Text.getUuidRfc4122()
         })
   
         // The payload is available only on a successful response
         if (!response.isSuccess) {
           console.error(response.getErrorMessages().join('; '))
           return
         }
   
         const result = response.getData().result
         console.info(`Created item #${result.item.id} (${result.item.title})`)
       } catch (error) {
         // Thrown on transport or SDK failures (AjaxError, SdkError, etc.)
         console.error(error)
       }
     }
   
     document.addEventListener('DOMContentLoaded', addCrmItem)
   </script>
   

   from b24pysdk.errors import BitrixAPIError, BitrixSDKException
   
   try:
       bitrix_response = client.crm.item.add(
           entity_type_id=1302,
           fields=
           {
               "ufCrm44_1721812760630": "Строка для пользовательского поля типа Строка",
               "ufCrm44_1721812814433": 81,
               "ufCrm44_1721812853419": "2024-08-21",
               "ufCrm44_1721812885588": [
                   "example.com",
                   "second-example.com",
               ],
               "ufCrm44_1721812898903": [
                   "green_pixel.png",
                   "iVBORw0KGgoAAAANSUhEUgAAAIAAAAAMCAYAAACqTLVoAAAALklEQVR42u3SAQEAAAQDsEsuOj3YMqwy6fBWCSCAAAIgAAIgAAIgAAIgAAJw3QLOrRH1U/gU4gAAAABJRU5ErkJggg==",
               ],
               "ufCrm44_1721812915476": "300|RUB",
               "ufCrm44_1721812935209": "Y",
               "ufCrm44_1721812948498": 9999.9,
           }
       ).response
       result = bitrix_response.result
       print(result)
   except BitrixAPIError as error:
       print(
           "Ошибка Bitrix API",
           f"error: {error.error}",
           f"error_description: {error.error_description}",
           sep="\n",
       )
   except BitrixSDKException as error:
       print(f"Ошибка Bitrix SDK: {error.message}")
   except Exception as error:
       print(f"Непредвиденная ошибка: {error}")
   

   require_once('crest.php');
   
   $result = CRest::call(
       'crm.item.add',
       [
           'entityTypeId' => 2,
           'fields' => [
               'title' => "Новая сделка (специально для примера REST методов)",
               'typeId' => "SERVICE",
               'categoryId' => 9,
               'stageId' => "C9:UC_KN8KFI",
               'isReccurring' => "Y",
               'probability' => 50,
               'currencyId' => "RUB",
               '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' => "Тут должно быть дополнительное описание об источнике",
               'leadId' => 102,
               'additionalInfo' => "Тут должна быть дополнительная информация",
               '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);
   }
   

   // client и ctx уже созданы — см. раздел «SDK для Go»
   res, err := client.Core().Call(ctx, "crm.item.add", b24.Params{
   	"entityTypeId": 2,
   	"fields": b24.Params{
   		"title":               "Новая сделка (специально для примера REST методов)",
   		"typeId":              "SERVICE",
   		"categoryId":          9,
   		"stageId":             "C9:UC_KN8KFI",
   		"isReccurring":        "Y",
   		"probability":         50,
   		"currencyId":          "RUB",
   		"isManualOpportunity": "Y",
   		"opportunity":         999.99,
   		"taxValue":            99.9,
   		"companyId":           5,
   		"contactId":           4,
   		"contactIds":          []int{4, 5},
   		"quoteId":             7,
   		"begindate":           "formatDate(monthAgo)",
   		"closedate":           "formatDate(twelveDaysInAdvance)",
   		"opened":              "N",
   		"comments":            "commentsExample",
   		"assignedById":        6,
   		"sourceId":            "WEB",
   		"sourceDescription":   "Тут должно быть дополнительное описание об источнике",
   		"leadId":              102,
   		"additionalInfo":      "Тут должна быть дополнительная информация",
   		"observers":           []int{2, 3},
   		"utmSource":           "google",
   		"utmMedium":           "CPC",
   		"ufCrm_1721244707107": 1111.1,
   		"parentId1220":        2,
   	},
   })
   if err != nil {
   	return fmt.Errorf("crm.item.add: %w", err)
   }
   
   // Ответ приходит как json.RawMessage — разберите его
   // в структуру под форму ответа, показанную ниже на этой странице.
   fmt.Printf("%s\n", res.Result)
   

2. Пример создания элемента смарт-процесса, у которого есть некоторый набор пользовательских полей

   Пользовательские поля, участвующие в примере

   {
   "ufCrm44_1721812760630": {
       "type": "string",
       "isRequired": false,
       "isReadOnly": false,
       "isImmutable": false,
       "isMultiple": false,
       "isDynamic": true,
       "title": "Пользовательское поле (строка)",
       "listLabel": "Пользовательское поле (строка)",
       "formLabel": "Пользовательское поле (строка)",
       "filterLabel": "Пользовательское поле (строка)",
       "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": "Элемент списка #1"
       },
       {
           "ID": "80",
           "VALUE": "Элемент списка #2"
       },
       {
           "ID": "81",
           "VALUE": "Элемент списка #3"
       },
       {
           "ID": "82",
           "VALUE": "Элемент списка #4"
       }
       ],
       "title": "Пользовательское поле (список)",
       "listLabel": "Пользовательское поле (список)",
       "formLabel": "Пользовательское поле (список)",
       "filterLabel": "Пользовательское поле (список)",
       "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": "Пользовательское поле (дата)",
       "listLabel": "Пользовательское поле (дата)",
       "formLabel": "Пользовательское поле (дата)",
       "filterLabel": "Пользовательское поле (дата)",
       "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": "Множественное пользовательское поле (ссылка)",
       "listLabel": "Множественное пользовательское поле (ссылка)",
       "formLabel": "Множественное пользовательское поле (ссылка)",
       "filterLabel": "Множественное пользовательское поле (ссылка)",
       "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": "Пользовательское поле (файл)",
       "listLabel": "Пользовательское поле (файл)",
       "formLabel": "Пользовательское поле (файл)",
       "filterLabel": "Пользовательское поле (файл)",
       "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": "Пользовательское поле (деньги)",
       "listLabel": "Пользовательское поле (деньги)",
       "formLabel": "Пользовательское поле (деньги)",
       "filterLabel": "Пользовательское поле (деньги)",
       "settings": {
       "DEFAULT_VALUE": ""
       },
       "upperName": "UF_CRM_44_1721812915476"
   },
   "ufCrm44_1721812935209": {
       "type": "boolean",
       "isRequired": false,
       "isReadOnly": false,
       "isImmutable": false,
       "isMultiple": false,
       "isDynamic": true,
       "title": "Пользовательское поле (Да/Нет)",
       "listLabel": "Пользовательское поле (Да/Нет)",
       "formLabel": "Пользовательское поле (Да/Нет)",
       "filterLabel": "Пользовательское поле (Да/Нет)",
       "settings": {
       "DEFAULT_VALUE": 0,
       "DISPLAY": "CHECKBOX",
       "LABEL": [
           "",
           ""
       ],
       "LABEL_CHECKBOX": {
           "en": "Пользовательское поле (Да/Нет)",
           "ru": "Пользовательское поле (Да/Нет)",
           "th": "Пользовательское поле (Да/Нет)",
           "la": "Пользовательское поле (Да/Нет)",
           "tc": "Пользовательское поле (Да/Нет)",
           "sc": "Пользовательское поле (Да/Нет)",
           "br": "Пользовательское поле (Да/Нет)",
           "ar": "Пользовательское поле (Да/Нет)",
           "fr": "Пользовательское поле (Да/Нет)",
           "vn": "Пользовательское поле (Да/Нет)",
           "pl": "Пользовательское поле (Да/Нет)",
           "tr": "Пользовательское поле (Да/Нет)",
           "ja": "Пользовательское поле (Да/Нет)",
           "it": "Пользовательское поле (Да/Нет)",
           "ms": "Пользовательское поле (Да/Нет)",
           "id": "Пользовательское поле (Да/Нет)"
       }
       },
       "upperName": "UF_CRM_44_1721812935209"
   },
   "ufCrm44_1721812948498": {
       "type": "double",
       "isRequired": false,
       "isReadOnly": false,
       "isImmutable": false,
       "isMultiple": false,
       "isDynamic": true,
       "title": "Пользовательское поле (число)",
       "listLabel": "Пользовательское поле (число)",
       "formLabel": "Пользовательское поле (число)",
       "filterLabel": "Пользовательское поле (число)",
       "settings": {
       "PRECISION": 2,
       "SIZE": 20,
       "MIN_VALUE": 0,
       "MAX_VALUE": 0,
       "DEFAULT_VALUE": null
       },
       "upperName": "UF_CRM_44_1721812948498"
   }
   }
   
   cURL (Webhook)

   cURL (OAuth)

   JS (TS)

   JS (UMD)

   Python

   PHP CRest

   Go

   curl -X POST \
   -H "Content-Type: application/json" \
   -H "Accept: application/json" \
   -d '{
       "entityTypeId": 1302,
       "fields": {
           "ufCrm44_1721812760630": "Строка для пользовательского поля типа Строка",
           "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|RUB",
           "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": "Строка для пользовательского поля типа Строка",
           "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|RUB",
           "ufCrm44_1721812935209": "Y",
           "ufCrm44_1721812948498": 9999.9
       },
       "auth": "**put_access_token_here**"
   }' \
   https://**put_your_bitrix24_address**/rest/crm.item.add
   

   // This snippet is an ES module: top-level await requires type="module" or a bundler.
   // $b24 is an already-initialized SDK instance (see the SDK "Get started" guide).
   import { Text } from '@bitrix24/b24jssdk'
   import type { B24Frame } from '@bitrix24/b24jssdk'
   
   declare const $b24: B24Frame
   
   type CrmItem = {
     id: number
     title: string
   }
   
   // Shape of the payload returned in result (match the "response handling" section of the page)
   type ItemAddResult = {
     item: CrmItem
   }
   
   const greenPixelInBase64 = 'iVBORw0KGgoAAAANSUhEUgAAAIAAAAAMCAYAAACqTLVoAAAALklEQVR42u3SAQEAAAQDsEsuOj3YMqwy6fBWCSCAAAIgAAIgAAIgAAIgAAJw3QLOrRH1U/gU4gAAAABJRU5ErkJggg=='
   
   try {
     const response = await $b24.actions.v2.call.make<ItemAddResult>({
       method: 'crm.item.add',
       params: {
         entityTypeId: 1302,
         fields: {
           ufCrm44_1721812760630: 'Value for a String-type custom field',
           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|RUB',
           ufCrm44_1721812935209: 'Y',
           ufCrm44_1721812948498: 9999.9,
         },
       },
       requestId: Text.getUuidRfc4122()
     })
   
     // The payload is available only on a successful response
     if (!response.isSuccess) {
       console.error(response.getErrorMessages().join('; '))
     } else {
       const result = response.getData()!.result
       console.info(`Created item #${result.item.id} (${result.item.title})`)
     }
   } catch (error) {
     // Thrown on transport or SDK failures (AjaxError, SdkError, etc.)
     console.error(error)
   }
   

   <!-- Load the SDK (UMD build); it is exposed as the global B24Js -->
   <script src="https://unpkg.com/@bitrix24/b24jssdk@1/dist/umd/index.min.js"></script>
   <script>
     async function addCrmItemWithCustomFields() {
       try {
         // Initialize the SDK inside a Bitrix24 frame
         const $b24 = await B24Js.initializeB24Frame()
   
         const greenPixelInBase64 = 'iVBORw0KGgoAAAANSUhEUgAAAIAAAAAMCAYAAACqTLVoAAAALklEQVR42u3SAQEAAAQDsEsuOj3YMqwy6fBWCSCAAAIgAAIgAAIgAAIgAAJw3QLOrRH1U/gU4gAAAABJRU5ErkJggg=='
   
         const response = await $b24.actions.v2.call.make({
           method: 'crm.item.add',
           params: {
             entityTypeId: 1302,
             fields: {
               ufCrm44_1721812760630: 'Value for a String-type custom field',
               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|RUB',
               ufCrm44_1721812935209: 'Y',
               ufCrm44_1721812948498: 9999.9,
             },
           },
           requestId: B24Js.Text.getUuidRfc4122()
         })
   
         // The payload is available only on a successful response
         if (!response.isSuccess) {
           console.error(response.getErrorMessages().join('; '))
           return
         }
   
         const result = response.getData().result
         console.info(`Created item #${result.item.id} (${result.item.title})`)
       } catch (error) {
         // Thrown on transport or SDK failures (AjaxError, SdkError, etc.)
         console.error(error)
       }
     }
   
     document.addEventListener('DOMContentLoaded', addCrmItemWithCustomFields)
   </script>
   

   from b24pysdk.errors import BitrixAPIError, BitrixSDKException
   
   try:
       bitrix_response = client.crm.item.add(
           entity_type_id=1302,
           fields={
               "ufCrm44_1721812760630": "Строка для пользовательского поля типа Строка",
               "ufCrm44_1721812814433": 81,
               "ufCrm44_1721812853419": "2024-08-21",
               "ufCrm44_1721812885588": [
                   "example.com",
                   "second-example.com",
               ],
               "ufCrm44_1721812898903": [
                   "green_pixel.png",
                   "iVBORw0KGgoAAAANSUhEUgAAAIAAAAAMCAYAAACqTLVoAAAALklEQVR42u3SAQEAAAQDsEsuOj3YMqwy6fBWCSCAAAIgAAIgAAIgAAIgAAJw3QLOrRH1U/gU4gAAAABJRU5ErkJggg==",
               ],
               "ufCrm44_1721812915476": "300|RUB",
               "ufCrm44_1721812935209": "Y",
               "ufCrm44_1721812948498": 9999.9,
           },
       ).response
       result = bitrix_response.result
       print(result)
   except BitrixAPIError as error:
       print(
           "Ошибка Bitrix API",
           f"error: {error.error}",
           f"error_description: {error.error_description}",
           sep="\n",
       )
   except BitrixSDKException as error:
       print(f"Ошибка Bitrix SDK: {error.message}")
   except Exception as error:
       print(f"Непредвиденная ошибка: {error}")
   

   require_once('crest.php');
   
   $result = CRest::call(
       'crm.item.add',
       [
           'entityTypeId' => 1302,
           'fields' => [
               'ufCrm44_1721812760630' => "Строка для пользовательского поля типа Строка",
               '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|RUB",
               'ufCrm44_1721812935209' => "Y",
               'ufCrm44_1721812948498' => 9999.9,
           ],
       ]
   );
   
   echo '<PRE>';
   print_r($result);
   echo '</PRE>';
   

   // client и ctx уже созданы — см. раздел «SDK для Go»
   res, err := client.Core().Call(ctx, "crm.item.add", b24.Params{
   	"entityTypeId": 1302,
   	"fields": b24.Params{
   		"ufCrm44_1721812760630": "Строка для пользовательского поля типа Строка",
   		"ufCrm44_1721812814433": 81,
   		"ufCrm44_1721812853419": time.Now().Format(time.RFC3339),
   		"ufCrm44_1721812885588": []string{"example.com", "second-example.com"},
   		"ufCrm44_1721812898903": []string{"green_pixel.png", "iVBORw0KGgoAAAANSUhEUgAAAIAAAAAMCAYAAACqTLVoAAAALklEQVR42u3SAQEAAAQDsEsuOj3YMqwy6fBWCSCAAAIgAAIgAAIgAAIgAAJw3QLOrRH1U/gU4gAAAABJRU5ErkJggg=="},
   		"ufCrm44_1721812915476": "300|RUB",
   		"ufCrm44_1721812935209": "Y",
   		"ufCrm44_1721812948498": 9999.9,
   	},
   })
   if err != nil {
   	return fmt.Errorf("crm.item.add: %w", err)
   }
   
   // Метод заворачивает ответ в объект с ключом "item".
   raw, ok := b24.Unwrap(res.Result, "item")
   if !ok {
   	return fmt.Errorf("в ответе нет ключа item")
   }
   
   var item struct {
   	ID           b24.ID `json:"id"`
   	CreatedTime  string `json:"createdTime"`
   	UpdatedTime  string `json:"updatedTime"`
   	CreatedBy    int    `json:"createdBy"`
   	UpdatedBy    int    `json:"updatedBy"`
   	AssignedByID b24.ID `json:"assignedById"`
   }
   if err := json.Unmarshal(raw, &item); err != nil {
   	return fmt.Errorf("разбор ответа: %w", err)
   }
   fmt.Println(item.ID, item.CreatedTime)
   

Обработка ответаОбработка ответа

HTTP-статус: 200

{
    "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": "Новая сделка (специально для примера rest методов)",
            "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": "RUB",
            "probability": 50,
            "comments": "\nПример комментария внутри сделки\n\n[B]Жирный текст[/B]\n[I]Курсив[/I]\n[U]Подчеркнутый[/U]\n[S]Зачеркнутый[/S]\n[B][I][U][S]Микс[/S][/U][/I][/B]\n\n[LIST]\n[*]Элемент списка #1\n[*]Элемент списка #2\n[*]Элемент списка #3\n[/LIST]\n\n[LIST=1]\n[*]Нумерованный элемент списка #1\n[*]Нумерованный элемент списка #2\n[*]Нумерованный элемент списка #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": "Тут должно быть дополнительное описание об источнике",
            "originatorId": null,
            "originId": null,
            "additionalInfo": "Тут должна быть дополнительная информация",
            "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
    }
}

Возвращаемые данныеВозвращаемые данные

Обработка ошибокОбработка ошибок

HTTP-статус: 400, 403

{
    "error": "NOT_FOUND",
    "error_description": "Смарт-процесс не найден"
}

Возможные коды ошибокВозможные коды ошибок

Статусы и коды системных ошибокСтатусы и коды системных ошибок

HTTP-статус: 4xx, 5xx

Описанные ниже ошибки возвращает сам REST API, а не логика конкретного метода. Они могут прийти в ответ на любой метод.

Продолжите изучениеПродолжите изучение

• Обновить элемент crm.item.update
• Получить элемент по Id crm.item.get
• Получить список элементов crm.item.list
• Удалить элемент crm.item.delete
• Получить поля элемента crm.item.fields
• Поля объектов CRM
• Как создать поставщика в CRM