# crm.activity.add URL: https://chugunov.pro/api-bitrix24/crm/timeline/activities/activity-base/crm-activity-add/ Проверено на Битрикс24 REST API, обновлено 11.09.2026 (ревизия источника fb39d6c). Источник: официальная документация Битрикс24 (bitrix-tools/b24-rest-docs, лицензия MIT, © Bitrix). Справочник независимый, официальной документацией не является. Добавить системное дело Scope: `crm` Кто может выполнять метод: пользователь с правом на добавление дела > Устаревший метод. Развитие метода остановлено. Используйте crm.activity.todo.add. ## Описание Метод `crm.activity.add` создает новое системное дело. ## Параметры - `fields` `array` — обязательный. Массив значений [полей дела](#fields) в виде структуры: ```json fields: { "OWNER_TYPE_ID": 2, "OWNER_ID": 102, "TYPE_ID": 2, "SUBJECT": "Новый звонок", } ``` Имеется дополнительное поле `DISABLE_SENDING_MESSAGE_COPY`. Оно предназначено для принудительного отключения отправки копии сообщения адресату из MESSAGE_FROM. Если параметр не заполнен или указано любое значение отличное от `Y` - копия отправлена будет. Пример: ```js [ 'fields'=> array( 'SETTINGS'=> array( 'DISABLE_SENDING_MESSAGE_COPY'=>'Y' ) ) ] ``` ### Параметр fields - `OWNER_ID` `integer` — обязательный. Идентификатор элемента CRM - `OWNER_TYPE_ID` `integer` — обязательный. [Идентификатор типа объекта CRM](https://apidocs.bitrix24.ru/api-reference/crm/data-types.html#object_type) - `TYPE_ID` `crm_enum_activitytype` — обязательный. Тип дела. Чтобы получить доступные типы дел, используйте метод [crm.enum.activitytype](https://chugunov.pro/api-bitrix24/crm/auxiliary/enum/outdated/crm-enum-activity-type/). Чтобы создать дело с типом «задача», используйте метод [создания](https://chugunov.pro/api-bitrix24/tasks/tasks-task-add/) или [изменения](https://chugunov.pro/api-bitrix24/tasks/tasks-task-update/) задачи и укажите элемент CRM в поле `UF_CRM_TASK` - `ASSOCIATED_ENTITY_ID` `integer` — необязательный. Идентификатор связанного с делом элемента - `COMMUNICATIONS` `crm_activity_communication` — обязательный. [Описание коммуникации](https://chugunov.pro/api-bitrix24/crm/timeline/activities/activity-base/crm-activity-communication-fields/) - `DEADLINE` `datetime` — необязательный. Дата и время срока исполнения дела. Поле напрямую не устанавливается, значение берётся из START_TIME для звонка и встречи и из END_TIME для задачи - `DESCRIPTION` `string` — необязательный. Текстовое описание дела - `DESCRIPTION_TYPE` `crm_enum_contenttype` — необязательный. Тип описания - `DIRECTION` `crm_enum_activitydirection` — необязательный. Направление дела: входящее/исходящее. Актуально для звонков и писем, для встреч не используется - `END_TIME` `datetime` — необязательный. Время завершения дела - `FILES` `diskfile` — необязательный. Добавленные в дело файлы - `LOCATION` `string` — необязательный. Местоположение - `NOTIFY_TYPE` `crm_enum_activitynotifytype` — необязательный. Тип уведомления - `ORIGINATOR_ID` `string` — необязательный. Идентификатор источника данных, используется только для привязки к внешнему источнику - `ORIGIN_ID` `string` — необязательный. Идентификатор элемента в источнике данных, используется только для привязки к внешнему источнику - `ORIGIN_VERSION` `string` — необязательный. Оригинальная версия, используется для защиты данных от случайного перетирания внешней системой. Если данные были импортированы и не изменялись во внешней системе, то такие данные могут быть редактированы в CRM без опасения, что следующая выгрузка приведет к перетиранию данных - `PRIORITY` `crm_enum_activitypriority` — необязательный. Приоритет - `PROVIDER_DATA` `string` — необязательный. Дополнительные данные провайдера - `PROVIDER_GROUP_ID` `string` — необязательный. Идентификатор группы провайдера - `PROVIDER_ID` `string` — необязательный. Идентификатор провайдера - `PROVIDER_TYPE_ID` `string` — необязательный. Идентификатор типа провайдера, статус из справочника - `PROVIDER_PARAMS` `object` — необязательный. Дополнительные параметры провайдера - `RESPONSIBLE_ID` `user` — обязательный. Идентификатор пользователя, ответственного за дело - `SETTINGS` `object` — необязательный. Дополнительные настройки - `START_TIME` `datetime` — необязательный. Время начала выполнения дела - `STATUS` `crm_enum_activitystatus` — необязательный. Статус дела - `SUBJECT` `string` — необязательный. Дополнительное описание дела - `WEBDAV_ELEMENTS` `diskfile` — необязательный. Добавленные файлы. Устарел, сохраняется для совместимости - `IS_INCOMING_CHANNEL` `char` — необязательный. Флаг, говорящий дело создано из входящего канала или нет (`Y`/`N`) ## Ответ HTTP-статус: 200 ```json { "result": 999, "time": { "start": 1712132792.910734, "finish": 1712132793.530359, "duration": 0.6196250915527344, "processing": 0.032338857650756836, "date_start": "2024-04-03T10:26:32+02:00", "date_finish": "2024-04-03T10:26:33+02:00", "operating_reset_at": 1705765533, "operating": 3.3076241016387939 } } ``` ### Возвращаемые данные - `result` `integer`. Идентификатор дела в таймлайне - `time` `time`. Информация о времени выполнения запроса ## Ошибки HTTP-статус: 400 ```json { "error": "", "error_description": "Access denied." } ``` - `The field SUBJECT is not defined or empty` — Поле `SUBJECT` не установлено - `The field RESPONSIBLE_ID is not defined or invalid` — Поле `RESPONSIBLE_ID` не установлено - `The field TYPE_ID is not defined or invalid` — Поле `TYPE_ID` не установлено - `The field COMMUNICATIONS is not defined or invalid` — Поле `COMMUNICATIONS` не установлено - `The only one communication is allowed for activity of specified type` — Количество контактов более 1 - `Could not build binding. Please ensure that owner info and communications are defined correctly` — Связи для дела не указаны - `The custom activity without provider is not supported in current context` — Тип дела не поддерживается в заданном контексте - `Use crm.activity.configurable.add for this activity provider` — Некорректный вызов метода для конфигурируемого дела - `Access denied` — Отсутствуют права на добавление сущности в CRM - `Application context required` — Некорректный параметр `PROVIDER_ID` для дела, созданного в контексте приложения ## Примеры запроса ### cURL (Webhook) ```bash curl -X POST \ -H "Content-Type: application/json" \ -H "Accept: application/json" \ -d '{"fields":{"OWNER_TYPE_ID":2,"OWNER_ID":102,"TYPE_ID":2,"COMMUNICATIONS":[{"VALUE":"+79832322323","ENTITY_ID":134,"ENTITY_TYPE_ID":3}],"SUBJECT":"Новый звонок","START_TIME":"2023-12-31T12:00:00+00:00","END_TIME":"2023-12-31T12:30:00+00:00","COMPLETED":"N","PRIORITY":3,"RESPONSIBLE_ID":1,"DESCRIPTION":"Важный звонок","DESCRIPTION_TYPE":3,"DIRECTION":2,"FILES":[{"fileData":["example.jpg","base64_encoded_content_here"]}]} }' \ https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/crm.activity.add ``` ### cURL (OAuth) ```bash curl -X POST \ -H "Content-Type: application/json" \ -H "Accept: application/json" \ -d '{"fields":{"OWNER_TYPE_ID":2,"OWNER_ID":102,"TYPE_ID":2,"COMMUNICATIONS":[{"VALUE":"+79832322323","ENTITY_ID":134,"ENTITY_TYPE_ID":3}],"SUBJECT":"Новый звонок","START_TIME":"2023-12-31T12:00:00+00:00","END_TIME":"2023-12-31T12:30:00+00:00","COMPLETED":"N","PRIORITY":3,"RESPONSIBLE_ID":1,"DESCRIPTION":"Важный звонок","DESCRIPTION_TYPE":3,"DIRECTION":2,"FILES":[{"fileData":["example.jpg","base64_encoded_content_here"]}]},"auth":"**put_access_token_here**"}' \ https://**put_your_bitrix24_address**/rest/crm.activity.add ``` ### JS (TS) ```ts // 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 try { const response = await $b24.actions.v2.call.make({ method: 'crm.activity.add', params: { fields: { OWNER_TYPE_ID: 2, OWNER_ID: 102, TYPE_ID: 2, COMMUNICATIONS: [ { VALUE: '+79832322323', ENTITY_ID: 134, ENTITY_TYPE_ID: 3 }, ], SUBJECT: 'New call', START_TIME: '2023-12-31T12:00:00+00:00', END_TIME: '2023-12-31T12:30:00+00:00', COMPLETED: 'N', PRIORITY: 3, RESPONSIBLE_ID: 1, DESCRIPTION: 'Important call', DESCRIPTION_TYPE: 3, DIRECTION: 2, FILES: [ { fileData: [ 'example.jpg', 'base64_encoded_content_here', ], }, ], }, }, 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 activity ID:', result) } } catch (error) { // Thrown on transport or SDK failures (AjaxError, SdkError, etc.) console.error(error) } ``` ### JS (UMD) ```html ``` ### Python ```python from datetime import datetime, timedelta from b24pysdk.errors import BitrixAPIError, BitrixSDKException try: bitrix_response = client.crm.activity.add( fields={ "OWNER_TYPE_ID": 2, "OWNER_ID": 101, "TYPE_ID": 2, "SUBJECT": "Follow up with customer", "START_TIME": datetime.now().isoformat(timespec="seconds"), "END_TIME": (datetime.now() + timedelta(hours=1)).isoformat(timespec="seconds"), "DEADLINE": (datetime.now() + timedelta(hours=1)).isoformat(timespec="seconds"), "COMPLETED": "N", "RESPONSIBLE_ID": 1, "PRIORITY": 2, "DESCRIPTION": "Discuss proposal details", "DESCRIPTION_TYPE": 3, "DIRECTION": 2, }, ).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}") ``` ### PHP ```php try { $response = $b24Service ->core ->call( 'crm.activity.add', [ 'fields' => [ 'OWNER_TYPE_ID' => 2, 'OWNER_ID' => 102, 'TYPE_ID' => 2, 'COMMUNICATIONS' => [ ['VALUE' => '+79832322323', 'ENTITY_ID' => 134, 'ENTITY_TYPE_ID' => 3] ], 'SUBJECT' => 'Новый звонок', 'START_TIME' => '2023-12-31T12:00:00+00:00', 'END_TIME' => '2023-12-31T12:30:00+00:00', 'COMPLETED' => 'N', 'PRIORITY' => 3, 'RESPONSIBLE_ID' => 1, 'DESCRIPTION' => 'Важный звонок', 'DESCRIPTION_TYPE' => 3, 'DIRECTION' => 2, 'FILES' => [ [ 'fileData' => [ 'example.jpg', 'base64_encoded_content_here' ] ] ] ] ] ); $result = $response ->getResponseData() ->getResult(); echo 'Success: ' . print_r($result, true); // Нужная вам логика обработки данных processData($result); } catch (Throwable $e) { error_log($e->getMessage()); echo 'Error adding activity: ' . $e->getMessage(); } ``` ### BX24.js ```javascript BX24.callMethod( "crm.activity.add", { fields: { "OWNER_TYPE_ID": 2, "OWNER_ID": 102, "TYPE_ID": 2, "COMMUNICATIONS": [ { VALUE: "+79832322323", ENTITY_ID: 134, ENTITY_TYPE_ID: 3 } ], "SUBJECT": "Новый звонок", "START_TIME": "2023-12-31T12:00:00+00:00", // Пример даты и времени "END_TIME": "2023-12-31T12:30:00+00:00", // Пример даты и времени "COMPLETED": "N", "PRIORITY": 3, "RESPONSIBLE_ID": 1, "DESCRIPTION": "Важный звонок", "DESCRIPTION_TYPE": 3, "DIRECTION": 2, "FILES": [ { fileData: [ "example.jpg", // Имя файла "base64_encoded_content_here" // Контент файла в формате base64 ] } ] } }, result => { if (result.error()) { console.error(result.error()); } else { console.dir(result.data()); } } ); ``` ### PHP CRest ```php require_once('crest.php'); $result = CRest::call( 'crm.activity.add', [ 'fields' => [ 'OWNER_TYPE_ID' => 2, 'OWNER_ID' => 102, 'TYPE_ID' => 2, 'COMMUNICATIONS' => [ [ 'VALUE' => '+79832322323', 'ENTITY_ID' => 134, 'ENTITY_TYPE_ID' => 3 ] ], 'SUBJECT' => 'Новый звонок', 'START_TIME' => '2023-12-31T12:00:00+00:00', // Пример даты и времени 'END_TIME' => '2023-12-31T12:30:00+00:00', // Пример даты и времени 'COMPLETED' => 'N', 'PRIORITY' => 3, 'RESPONSIBLE_ID' => 1, 'DESCRIPTION' => 'Важный звонок', 'DESCRIPTION_TYPE' => 3, 'DIRECTION' => 2, 'FILES' => [ [ 'fileData' => [ 'example.jpg', // Имя файла 'base64_encoded_content_here' // Контент файла в формате base64 ] ] ] ] ] ); if (isset($result['error'])) { echo 'Ошибка: ' . $result['error_description']; } else { echo '
';
    print_r($result['result']);
    echo '
'; } ``` ### Go ```go // client и ctx уже созданы — см. раздел «SDK для Go» res, err := client.Core().Call(ctx, "crm.activity.add", b24.Params{ "fields": b24.Params{ "OWNER_TYPE_ID": 2, "OWNER_ID": 102, "TYPE_ID": 2, "COMMUNICATIONS": []b24.Params{ { "VALUE": "+79832322323", "ENTITY_ID": 134, "ENTITY_TYPE_ID": 3, }, }, "SUBJECT": "Новый звонок", "START_TIME": "2023-12-31T12:00:00+00:00", "END_TIME": "2023-12-31T12:30:00+00:00", "COMPLETED": "N", "PRIORITY": 3, "RESPONSIBLE_ID": 1, "DESCRIPTION": "Важный звонок", "DESCRIPTION_TYPE": 3, "DIRECTION": 2, "FILES": []b24.Params{ { "fileData": []string{"example.jpg", "base64_encoded_content_here"}, }, }, }, }) if err != nil { return fmt.Errorf("crm.activity.add: %w", err) } var newID b24.ID if err := json.Unmarshal(res.Result, &newID); err != nil { return fmt.Errorf("разбор ответа: %w", err) } fmt.Println("идентификатор:", newID) ``` Оригинал в официальной документации: https://apidocs.bitrix24.ru/api-reference/crm/timeline/activities/activity-base/crm-activity-add.html