Добавить задачу tasks.task.add
Scope:
tasksКто может выполнять метод: любой пользователь
Метод tasks.task.add добавляет новую задачу.
Параметры метода
Обязательные параметры отмечены *
|
Название |
Описание |
|
fields* |
Поля задачи. Для создания задачи заполните обязательные поля, без них операция создания не будет выполнена |
Параметр fields
Обязательные параметры отмечены *
|
Название |
Описание |
|
title* |
Название задачи |
|
creatorId* |
Идентификатор постановщика. |
|
responsibleId* |
Идентификатор исполнителя. |
Примеры кода
Как использовать примеры в документации
Вызов нового api отличается добавлением параметра /api/ в запросе:
https://{адрес_установки}/rest/api/{id_пользователя}/{токен_вебхука}/tasks.task.add
curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"fields":{"title":"Название задачи","deadline":"2025-12-31T23:59:59+02:00","creatorId":29,"responsibleId":1,"crmItemIds":["L_1000959"]}}' \
https://**put_your_bitrix24_address**/rest/api/**put_your_user_id_here**/**put_your_webhook_here**/tasks.task.add
curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"fields":{"title":"Название задачи","deadline":"2025-12-31T23:59:59+02:00","creatorId":29,"responsibleId":1,"crmItemIds":["L_1000959"]},"auth":"**put_access_token_here**"}' \
https://**put_your_bitrix24_address**/rest/api/tasks.task.add
SDK пока не поддерживают в вызовах адрес /rest/api/. Используйте прямые HTTP-запросы, например, через curl, fetch.
try
{
const response = await $b24.callMethod(
'tasks.task.add',
{
fields: {
title: 'Название задачи',
deadline: '2025-12-31T23:59:59+02:00',
creatorId: 29,
responsibleId: 1,
crmItemIds: ['L_1000959']
}
}
);
const result = response.getData().result;
console.info('Task created with ID', result.item?.id);
}
catch( error )
{
console.error(error);
}
SDK пока не поддерживают в вызовах адрес /rest/api/. Используйте прямые HTTP-запросы, например, через curl, fetch.
try {
$response = $b24Service
->core
->call(
'tasks.task.add',
[
'fields' => [
'title' => 'Название задачи',
'deadline' => '2025-12-31T23:59:59+02:00',
'creatorId' => 29,
'responsibleId' => 1,
'crmItemIds' => ['L_1000959'],
],
]
);
$result = $response
->getResponseData()
->getResult();
echo 'Success: ' . print_r($result, true);
} catch (Throwable $e) {
error_log($e->getMessage());
echo 'Error creating task: ' . $e->getMessage();
}
SDK пока не поддерживают в вызовах адрес /rest/api/. Используйте прямые HTTP-запросы, например, через curl, fetch.
BX24.callMethod(
'tasks.task.add',
{
fields: {
title: 'Название задачи',
deadline: '2025-12-31T23:59:59+02:00',
creatorId: 29,
responsibleId: 1,
crmItemIds: ['L_1000959']
}
},
function(result){
console.info(result.data());
console.log(result);
}
);
SDK пока не поддерживают в вызовах адрес /rest/api/. Используйте прямые HTTP-запросы, например, через curl, fetch.
require_once('crest.php');
$result = CRest::call(
'tasks.task.add',
[
'fields' => [
'title' => 'Название задачи',
'deadline' => '2025-12-31T23:59:59+02:00',
'creatorId' => 29,
'responsibleId' => 1,
'crmItemIds' => ['L_1000959']
]
]
);
echo '<PRE>';
print_r($result);
echo '</PRE>';
Обработка ответа
HTTP-статус: 200
{
"result": {
"item": {
"id": 3839,
"title": "Название задачи",
"description": "",
"deadline": "2026-01-01T00:59:59+03:00",
"needsControl": false,
"startPlan": null,
"endPlan": null,
"fileIds": null,
"checklist": [],
"epicId": null,
"storyPoints": null,
"priority": "average",
"status": "pending",
"statusChanged": null,
"parentId": null,
"containsChecklist": false,
"containsSubTasks": false,
"containsRelatedTasks": false,
"containsGanttLinks": false,
"containsPlacements": true,
"containsResults": false,
"numberOfReminders": 0,
"chatId": 2603,
"plannedDuration": 0,
"actualDuration": 0,
"durationType": "days",
"started": null,
"estimatedTime": 0,
"replicate": false,
"changed": "2025-12-11T12:25:33+03:00",
"closed": null,
"activity": "2025-12-11T12:25:33+03:00",
"guid": "{13d2c44c-730e-45dd-b99c-fdaad4e3c1fa}",
"xmlId": null,
"exchangeId": null,
"exchangeModified": null,
"outlookVersion": 1,
"mark": "none",
"allowsChangeDeadline": false,
"allowsTimeTracking": false,
"matchesWorkTime": false,
"addInReport": null,
"isMultitask": false,
"siteId": "s1",
"deadlineCount": null,
"declineReason": null,
"forumTopicId": null,
"link": "\/company\/personal\/user\/1\/tasks\/task\/view\/3839\/",
"rights": {
"read": true,
"watch": true,
"mute": true,
"createResult": true,
"edit": true,
"remove": true,
"complete": true,
"approve": false,
"disapprove": false,
"start": true,
"take": false,
"delegate": true,
"defer": true,
"renew": false,
"deadline": true,
"datePlan": true,
"changeDirector": false,
"changeResponsible": true,
"changeAccomplices": true,
"pause": false,
"timeTracking": false,
"mark": true,
"changeStatus": true,
"reminder": true,
"addAuditors": true,
"elapsedTime": true,
"favorite": true,
"checklistAdd": true,
"checklistEdit": true,
"checklistSave": true,
"checklistToggle": true,
"automate": true,
"resultEdit": false,
"completeResult": true,
"removeResult": false,
"resultRead": false,
"admin": true,
"createSubtask": true,
"copy": true,
"saveAsTemplate": true,
"attachFile": true,
"detachFile": true,
"detachParent": true,
"createGanttDependence": true,
"sort": false
},
"archiveLink": "\/bitrix\/tools\/disk\/uf.php?entityId=3839\u0026entity=TASKS_TASK\u0026fieldName=UF_TASK_WEBDAV_FILES\u0026signature=89f4f46e33905bcb0899c8cb9613a62cf8e104b182824e799d2aeb9d1e5bf526\u0026action=downloadArchiveByEntity\u0026ncc=1",
"crmItemIds": [
"L_1000959"
],
"requireResult": false,
"matchesSubTasksTime": false,
"autocompleteSubTasks": false,
"allowsChangeDatePlan": false,
"maxDeadlineChangeDate": null,
"maxDeadlineChanges": null,
"requireDeadlineChangeReason": false,
"inFavorite": [],
"inPin": [],
"inGroupPin": [],
"inMute": [],
"dependsOn": [],
"scenarios": [
"default"
]
}
},
"time": {
"start": 1765445133,
"finish": 1765445134.139558,
"duration": 1.1395580768585205,
"processing": 1,
"date_start": "2025-12-11T12:25:33+03:00",
"date_finish": "2025-12-11T12:25:34+03:00",
"operating_reset_at": 1765445733,
"operating": 0
}
}
Возвращаемые данные
|
Название |
Описание |
|
result |
Объект с данными ответа |
|
item |
Объект со значениями полей задачи. Описание полей задачи со связанными объектами |
|
time |
Информация о времени выполнения запроса |
Обработка ошибок
HTTP-статус: 400
{
"error": {
"code": "BITRIX_REST_V3_EXCEPTION_VALIDATION_REQUESTVALIDATIONEXCEPTION",
"message": "Ошибка при валидации объекта запроса",
"validation": [
{
"message": "В поле `deadline` требуется тип данных `DateTime` для такого запроса",
"field": "deadline"
}
]
}
}
|
Название |
Описание |
|
error.code |
Строковый код ошибки. Используйте для идентификации типа исключения |
|
error.message |
Текстовое описание ошибки |
|
error.validation |
Массив c деталями ошибки. Присутствует только в ошибках валидации данных |
|
error.validation[].field |
Название поля, в котором возникла ошибка валидации |
|
error.validation[].message |
Описание ошибки, связанной с указанным полем |
Возможные коды ошибок
Ошибки валидации запроса
Код ошибки: BITRIX_REST_V3_EXCEPTION_VALIDATION_REQUESTVALIDATIONEXCEPTION
|
Поле |
Описание ошибки |
Как исправить |
|
|
Обязательное поле |
Добавьте указанное поле в тело запроса |
|
|
В поле |
Убедитесь, что передаваемое значение нужного типа |
|
|
Пользователь указанный в поле "Исполнитель" не найден |
Укажите идентификатор существующего пользователя в поле |
|
|
"" |
Укажите идентификатор существующего пользователя в поле |
|
|
Задача указанная в поле "Надзадача" не найдена |
Укажите идентификатор существующей задачи в поле |
|
|
В планировании сроков указана дата окончания меньшая даты старта |
Укажите дату |
|
|
В планировании сроков указана слишком большая длительность задачи |
Уменьшите дату в поле |
Статусы и коды системных ошибок
HTTP-статус: 20x, 40x, 50x
Описанные ниже ошибки могут возникнуть при вызове любого метода
|
Статус |
Код |
Описание |
|
|
|
Возникла внутренняя ошибка сервера, обратитесь к администратору сервера или в техническую поддержку Битрикс24 |
|
|
|
Возникла внутренняя ошибка сервера, обратитесь к администратору сервера или в техническую поддержку Битрикс24 |
|
|
|
Превышен лимит на интенсивность запросов |
|
|
|
Текущий метод не разрешен для вызова с помощью batch |
|
|
|
Превышена максимальная длина параметров, переданных в метод batch |
|
|
|
Неверный access-токен или код вебхука |
|
|
|
Для вызовов методов требуется использовать протокол HTTPS |
|
|
|
REST API заблокирован из-за перегрузки. Это ручная индивидуальная блокировка, для снятия необходимо обращаться в техническую поддержку Битрикс24 |
|
|
|
REST API доступен только на коммерческих планах |
|
|
|
У пользователя, с чьим access-токеном или вебхуком был вызван метод, не хватает прав |
|
|
|
Манифест недоступен |
|
|
|
Запрос требует более высоких привилегий, чем предоставляет токен вебхука |
|
|
|
Предоставленный access-токен доступа истек |
|
|
|
Пользователь не имеет доступа к приложению. Это означает, что приложение установлено, но администратор портала разрешил доступ к этому приложению только конкретным пользователям |
|
|
|
Публичная часть сайта закрыта. Чтобы открыть публичную часть сайта на коробочной установке отключите опцию «Временное закрытие публичной части сайта». Путь к настройке: Рабочий стол > Настройки > Настройки продукта > Настройки модулей > Главный модуль > Временное закрытие публичной части сайта |
Продолжите изучение
- Обновить задачу tasks.task.update
- Отправить сообщение в чат задачи tasks.task.chat.message.send
- Удалить задачу tasks.task.delete
- Прикрепить файлы к задаче tasks.task.file.attach