# tasks.task.add URL: https://chugunov.pro/api-bitrix24/tasks/tasks-task-add/ Проверено на Битрикс24 REST API, обновлено 11.09.2026 (ревизия источника fb39d6c). Источник: официальная документация Битрикс24 (bitrix-tools/b24-rest-docs, лицензия MIT, © Bitrix). Справочник независимый, официальной документацией не является. Добавить задачу Scope: `task` Кто может выполнять метод: любой пользователь ## Описание Метод `tasks.task.add` добавляет новую задачу. ## Параметры - `fields` `object` — обязательный. Значения [полей задачи](https://apidocs.bitrix24.ru/api-reference/tasks/fields.html). Обязательные поля для создания задачи: - `TITLE` — название задачи - `RESPONSIBLE_ID` — идентификатор ответственного Проверьте, какие обязательные пользовательские поля настроены для задач в вашем Битрикс24. Все обязательные поля нужно передать в метод. В метод можно передать параметр `SE_PARAMETER` — список объектов с дополнительными параметрами задачи. Возможные значения кодов `CODE`: - `1` — сроки определяются сроками подзадач - `2` — автоматически завершать задачу при завершении подзадач (и наоборот) - `3` — не завершать задачу без результата ```js SE_PARAMETER: [ { VALUE: 'Y', CODE: 3 }, { VALUE: 'Y', CODE: 2 } ] ``` ## Ответ HTTP-статус: 200 ```json { "result": { "task": { "id": "3711", "parentId": null, "title": "task for test", "description": "", "mark": null, "priority": "1", "multitask": "N", "notViewed": "N", "replicate": "N", "stageId": "0", "createdBy": "1", "createdDate": "2024-11-02T10:06:08+02:00", "responsibleId": "1", "changedBy": "1", "changedDate": "2024-11-02T10:06:08+02:00", "statusChangedBy": null, "closedBy": null, "closedDate": null, "activityDate": "2024-11-02T10:06:08+02:00", "dateStart": null, "deadline": null, "startDatePlan": null, "endDatePlan": null, "guid": "{c2794da9-c7fe-404d-a709-ddab4578717a}", "xmlId": null, "commentsCount": null, "serviceCommentsCount": null, "allowChangeDeadline": "N", "allowTimeTracking": "N", "taskControl": "N", "addInReport": "N", "forkedByTemplateId": null, "timeEstimate": "0", "timeSpentInLogs": null, "matchWorkTime": "N", "forumTopicId": null, "forumId": null, "siteId": "s1", "subordinate": "Y", "exchangeModified": null, "exchangeId": null, "outlookVersion": "1", "viewedDate": null, "sorting": null, "durationFact": null, "isMuted": "N", "isPinned": "N", "isPinnedInGroup": "N", "flowId": null, "descriptionInBbcode": "Y", "status": "2", "statusChangedDate": "2024-11-02T10:06:08+02:00", "durationPlan": null, "durationType": "days", "favorite": "N", "groupId": "0", "auditors": [], "accomplices": [], "checklist": [], "group": [], "creator": { "id": "1", "name": "Viola", "link": "/company/personal/user/1/", "icon": "https://your-domain.bitrix24.com/b13743910/resize_cache/2267/c0120a8d7c10d63c83e32398d1ec4d9e/main/c7b/c7bd44b1babaa5448125dd97d038ce1b/d5fb56b94dc2c3cd8c006a2c595a4895.jpg", "workPosition": "" }, "responsible": { "id": "1", "name": "Viola", "link": "/company/personal/user/1/", "icon": "https://your-domain.bitrix24.com/b13743910/resize_cache/2267/c0120a8d7c10d63c83e32398d1ec4d9e/main/c7b/c7bd44b1babaa5448125dd97d038ce1b/d5fb56b94dc2c3cd8c006a2c595a4895.jpg", "workPosition": "" }, "accomplicesData": [], "auditorsData": [], "newCommentsCount": 0, "action": { "accept": false, "decline": false, "complete": true, "approve": false, "disapprove": false, "start": true, "pause": false, "delegate": true, "remove": true, "edit": true, "defer": true, "renew": false, "create": true, "changeDeadline": true, "checklistAddItems": true, "addFavorite": true, "deleteFavorite": false, "rate": true, "edit.originator": false, "checklist.reorder": true, "elapsedtime.add": true, "dayplan.timer.toggle": false, "edit.plan": true, "checklist.add": true, "favorite.add": true, "favorite.delete": false }, "checkListTree": { "nodeId": 0, "fields": { "id": null, "copiedId": null, "entityId": null, "userId": 1, "createdBy": null, "parentId": null, "title": "", "sortIndex": null, "displaySortIndex": "", "isComplete": false, "isImportant": false, "completedCount": 0, "members": [], "attachments": [] }, "action": [], "descendants": [] }, "checkListCanAdd": true } }, "time": { "start": 1758188171.142611, "finish": 1758188172.101309, "duration": 0.958698034286499, "processing": 0.9341180324554443, "date_start": "2025-09-18T12:36:11+03:00", "date_finish": "2025-09-18T12:36:12+03:00", "operating_reset_at": 1758188771, "operating": 0.9340989589691162 } } ``` ### Возвращаемые данные - `result` `object`. Объект с данными ответа - `task` `object`. Объект с [описанием задачи](https://apidocs.bitrix24.ru/api-reference/tasks/fields.html) после выполнения операции - `time` `time`. Информация о времени выполнения запроса ## Ошибки HTTP-статус: 400 ```json { "error": "ERROR_CORE", "error_description": "Не указано название задачи\u003Cbr\u003E" } ``` - `100` — Could not find value for parameter {fields} (internal error). Не передан параметр `fields` или передан пустой - `ERROR_CORE` — Пользователь указанный в поле "Исполнитель" не найден. В поле `RESPONSIBLE_ID` указан идентификатор несуществующего пользователя - `ERROR_CORE` — Не указан исполнитель. Не заполнено поле `RESPONSIBLE_ID` - `ERROR_CORE` — Не указано название задачи. Не заполнено поле `TITLE` - `ERROR_CORE` — Не введено значение обязательного поля {название_поля}. Не заполнено обязательное пользовательское поле с указанным названием - `ERROR_CORE` — Некорректный статус. Указано некорректное значение в поле `STATUS` - `ERROR_CORE` — Задача указанная в поле "Надзадача" не найдена. В поле `PARENT_ID` указан идентификатор несуществующей задачи - `ERROR_CORE` — В планировании сроков указана дата окончания меньшая даты старта. Дата и время в поле `END_DATE_PLAN` указано меньше, чем в `START_DATE_PLAN` - `ERROR_CORE` — В планировании сроков указана слишком большая длительность задачи. В значении поля `END_DATE_PLAN` указана слишком большая дата ## Примеры запроса ### cURL (Webhook) ```bash curl -X POST \ -H "Content-Type: application/json" \ -H "Accept: application/json" \ -d '{"fields":{"TITLE":"Название задачи","DEADLINE":"2025-12-31T23:59:59","CREATED_BY":456,"RESPONSIBLE_ID":123,"UF_CRM_TASK":["L_4","C_7","CO_5","D_10"],"UF_TASK_WEBDAV_FILES":["n12345","n67890"]}}' \ https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/tasks.task.add ``` ### cURL (OAuth) ```bash curl -X POST \ -H "Content-Type: application/json" \ -H "Accept: application/json" \ -d '{"fields":{"TITLE":"Название задачи","DEADLINE":"2025-12-31T23:59:59","CREATED_BY":456,"RESPONSIBLE_ID":123,"UF_CRM_TASK":["L_4","C_7","CO_5","D_10"],"UF_TASK_WEBDAV_FILES":["n12345","n67890"]},"auth":"**put_access_token_here**"}' \ https://**put_your_bitrix24_address**/rest/tasks.task.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 // Minimal shape of result.task; the API returns the full task object // Shape of the payload returned in result (match the "response handling" section of the page) type TaskAddResult = { task: { id: string } } try { const response = await $b24.actions.v2.call.make({ method: 'tasks.task.add', params: { fields: { TITLE: 'Task title', // Task title (required) DEADLINE: '2025-12-31T23:59:59', // Deadline, ISO 8601 CREATED_BY: 456, // Creator ID RESPONSIBLE_ID: 123, // Responsible person ID (required) // Bind the task to several CRM entities via UF_CRM_TASK UF_CRM_TASK: ['L_4', 'C_7', 'CO_5', 'D_10'], // Lead 4 / Contact 7 / Company 5 / Deal 10 // Attach several Drive files via UF_TASK_WEBDAV_FILES (prefix IDs with "n") UF_TASK_WEBDAV_FILES: ['n12345', 'n67890'] } }, requestId: Text.getUuidRfc4122() // optional unique tracking id for this request }) // 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(`Task created with ID ${result.task.id}`) } } catch (error) { // Thrown on transport or SDK failures (AjaxError, SdkError, etc.) console.error(error) } ``` ### JS (UMD) ```html ``` ### Python ```python from b24pysdk.errors import BitrixAPIError, BitrixSDKException fields = { "TITLE": "Task title", "DEADLINE": "2025-12-31T23:59:59", "CREATED_BY": 456, "RESPONSIBLE_ID": 123, "UF_CRM_TASK": [ "L_4", "C_7", "CO_5", "D_10", ], "UF_TASK_WEBDAV_FILES": [ "n12345", "n67890", ], } try: bitrix_response = client.tasks.task.add( fields=fields, ).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( 'tasks.task.add', [ 'fields' => [ 'TITLE' => 'Название задачи', 'DEADLINE' => '2025-12-31T23:59:59', 'CREATED_BY' => 456, 'RESPONSIBLE_ID' => 123, 'UF_CRM_TASK' => [ 'L_4', 'C_7', 'CO_5', 'D_10', ], 'UF_TASK_WEBDAV_FILES' => [ 'n12345', 'n67890', ], ], ] ); $result = $response ->getResponseData() ->getResult(); echo 'Задача успешно создана с ID ' . $result['task']['id']; } catch (Throwable $e) { error_log($e->getMessage()); echo 'Ошибка при создании задачи: ' . $e->getMessage(); } ``` ### BX24.js ```javascript BX24.callMethod( "tasks.task.add", { fields: { TITLE: "Название задачи", // Название задачи DEADLINE: "2025-12-31T23:59:59", // Крайний срок CREATED_BY: 456, // Идентификатор постановщика RESPONSIBLE_ID: 123, // Идентификатор исполнителя // Пример передачи нескольких значений в поле UF_CRM_TASK UF_CRM_TASK: [ "L_4", // Привязка к лиду "C_7", // Привязка к контакту "CO_5", // Привязка к компании "D_10" // Привязка к сделке ], // Пример передачи нескольких файлов в поле UF_TASK_WEBDAV_FILES UF_TASK_WEBDAV_FILES: [ "n12345", // Идентификатор первого файла диска "n67890" // Идентификатор второго файла диска ] } }, function(result) { if (result.error()) { console.error(result.error()); } else { console.info("Задача успешно создана с ID " + result.data().task.id); } } ); ``` ### PHP CRest ```php require_once('crest.php'); $result = CRest::call( 'tasks.task.add', [ 'fields' => [ 'TITLE' => 'Название задачи', // Название задачи 'DEADLINE' => '2025-12-31T23:59:59', // Крайний срок 'CREATED_BY' => 456, // Идентификатор постановщика 'RESPONSIBLE_ID' => 123, // Идентификатор исполнителя // Пример передачи нескольких значений в поле UF_CRM_TASK 'UF_CRM_TASK' => [ 'L_4', // Привязка к лиду 'C_7', // Привязка к контакту 'CO_5', // Привязка к компании 'D_10' // Привязка к сделке ], // Пример передачи нескольких файлов в поле UF_TASK_WEBDAV_FILES 'UF_TASK_WEBDAV_FILES' => [ 'n12345', // Идентификатор первого файла диска 'n67890' // Идентификатор второго файла диска ] ] ] ); if (isset($result['error'])) { echo 'Ошибка: ' . $result['error_description']; } else { echo 'Задача успешно создана с ID ' . $result['result']['task']['id']; } ``` ### Go ```go // client и ctx уже созданы — см. раздел «SDK для Go» res, err := client.Core().Call(ctx, "tasks.task.add", b24.Params{ "fields": b24.Params{ "TITLE": "Название задачи", "DEADLINE": "2025-12-31T23:59:59", "CREATED_BY": 456, "RESPONSIBLE_ID": 123, "UF_CRM_TASK": []string{"L_4", "C_7", "CO_5", "D_10"}, "UF_TASK_WEBDAV_FILES": []string{"n12345", "n67890"}, }, }) if err != nil { return fmt.Errorf("tasks.task.add: %w", err) } // Метод заворачивает ответ в объект с ключом "task". raw, ok := b24.Unwrap(res.Result, "task") if !ok { return fmt.Errorf("в ответе нет ключа task") } var item struct { ID b24.ID `json:"id"` Title string `json:"title"` Description string `json:"description"` Priority string `json:"priority"` Multitask string `json:"multitask"` NotViewed string `json:"notViewed"` } if err := json.Unmarshal(raw, &item); err != nil { return fmt.Errorf("разбор ответа: %w", err) } fmt.Println(item.ID, item.Title) ``` Оригинал в официальной документации: https://apidocs.bitrix24.ru/api-reference/tasks/tasks-task-add.html