[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"docs-entities\u002Ftasks\u002Fcreate":3,"docs-tabs-entities\u002Ftasks\u002Fcreate":6},{"content":4,"lastmod":5},"\n## Создать задачу\n\n`POST \u002Fv1\u002Ftasks`\n\nСоздаёт новую задачу. Минимум — название и ответственный.\n\n## Поля запроса (body)\n\n| Поле | Тип | Обяз. | Описание |\n|------|-----|:-----:|---------|\n| `title` | string | ★ | Название задачи |\n| `responsibleId` | number | ★ | Ответственный. Список сотрудников: `GET \u002Fv1\u002Fusers` |\n| `description` | string | | Описание задачи. Поддерживает BB-код (`[USER=ID]Имя[\u002FUSER]`, `[B]...[\u002FB]`, `[QUOTE]...[\u002FQUOTE]`) |\n| `priority` | number | | Приоритет: `0` — низкий, `1` — обычный (по умолчанию), `2` — высокий |\n| `status` | number | | Статус. По умолчанию `2` (ждёт выполнения). Полный список значений: `GET \u002Fv1\u002Ftasks\u002Ffields` → `fields.status.enum` |\n| `deadline` | datetime | | Крайний срок (ISO 8601) |\n| `startDatePlan` | datetime | | Плановая дата начала |\n| `endDatePlan` | datetime | | Плановая дата окончания |\n| `timeEstimate` | number | | Оценка трудозатрат в секундах |\n| `groupId` | number | | Рабочая группа. Список: `GET \u002Fv1\u002Fworkgroups` |\n| `parentId` | number | | Родительская задача. Список: `GET \u002Fv1\u002Ftasks` |\n| `accomplices` | number[] | | Соисполнители. Список сотрудников: `GET \u002Fv1\u002Fusers` |\n| `auditors` | number[] | | Наблюдатели. Список сотрудников: `GET \u002Fv1\u002Fusers` |\n| `tags` | string[] | | Метки задачи (массив строк-имён; принимаются прямо при создании) |\n| `createdBy` | number | | Постановщик. По умолчанию — пользователь ключа; переопределение применяется в пределах прав B24-пользователя |\n\nПолный список полей — [`GET \u002Fv1\u002Ftasks\u002Ffields`](.\u002Ffields.md). Поля `id`, `dateStart`, `createdDate`, `changedDate`, `closedDate`, `activityDate` заполняются системой и в body не передаются.\n\n> ⚠️ `title` ограничен 250 символами — более длинное название отклоняется порталом с ошибкой `TASKS_BAD_TITLE`.\n\n## Примеры\n\n### curl — личный ключ\n\n```bash\ncurl -X POST \"https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Ftasks\" \\\n  -H \"X-Api-Key: YOUR_API_KEY\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\n    \"title\": \"Подготовить отчёт за квартал\",\n    \"responsibleId\": 1,\n    \"priority\": 2,\n    \"deadline\": \"2026-05-19T18:00:00+03:00\"\n  }'\n```\n\n### curl — OAuth-приложение\n\n```bash\ncurl -X POST \"https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Ftasks\" \\\n  -H \"X-Api-Key: YOUR_APP_KEY\" \\\n  -H \"Authorization: Bearer USER_SESSION_TOKEN\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\n    \"title\": \"Подготовить отчёт за квартал\",\n    \"responsibleId\": 1,\n    \"priority\": 2,\n    \"deadline\": \"2026-05-19T18:00:00+03:00\"\n  }'\n```\n\n### JavaScript — личный ключ\n\n```javascript\nconst res = await fetch('https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Ftasks', {\n  method: 'POST',\n  headers: {\n    'X-Api-Key': 'YOUR_API_KEY',\n    'Content-Type': 'application\u002Fjson',\n  },\n  body: JSON.stringify({\n    title: 'Подготовить отчёт за квартал',\n    responsibleId: 1,\n    priority: 2,\n    deadline: '2026-05-19T18:00:00+03:00',\n  }),\n})\n\nconst { success, data } = await res.json()\nconsole.log('ID новой задачи:', data.id)\n```\n\n### JavaScript — OAuth-приложение\n\n```javascript\nconst res = await fetch('https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Ftasks', {\n  method: 'POST',\n  headers: {\n    'X-Api-Key': 'YOUR_APP_KEY',\n    'Authorization': 'Bearer USER_SESSION_TOKEN',\n    'Content-Type': 'application\u002Fjson',\n  },\n  body: JSON.stringify({\n    title: 'Подготовить отчёт за квартал',\n    responsibleId: 1,\n    priority: 2,\n    deadline: '2026-05-19T18:00:00+03:00',\n  }),\n})\n\nconst { success, data } = await res.json()\n```\n\n## Поля ответа\n\n| Поле | Тип | Описание |\n|------|-----|---------|\n| `success` | boolean | Всегда `true` при успехе |\n| `data` | object | Полный объект созданной задачи (как у `GET \u002Fv1\u002Ftasks\u002F:id`) — см. [Поля задачи](.\u002Ffields.md) |\n\nURL карточки задачи в Битрикс24 строится из `id` и ID сотрудника:\n\n```\nhttps:\u002F\u002F\u003Cportal>.bitrix24.ru\u002Fcompany\u002Fpersonal\u002Fuser\u002F\u003CresponsibleId>\u002Ftasks\u002Ftask\u002Fview\u002F\u003Cid>\u002F\n```\n\n`\u003CresponsibleId>` — ID ответственного (поле `responsibleId` в ответе): задача откроется в его личном кабинете. Сегмент `user\u002F\u003C...>` задаёт, в чьём кабинете отображается страница задач — подставьте ID нужного сотрудника, например текущего. `\u003Cportal>` — домен портала. Доступ ограничен правами сотрудника в Битрикс24.\n\n## Пример ответа\n\n```json\n{\n  \"success\": true,\n  \"data\": {\n    \"id\": \"3871\",\n    \"title\": \"Подготовить отчёт за квартал\",\n    \"description\": \"\",\n    \"status\": \"2\",\n    \"priority\": \"2\",\n    \"responsibleId\": \"1\",\n    \"createdBy\": \"1\",\n    \"createdDate\": \"2026-05-12T11:46:12+03:00\",\n    \"deadline\": \"2026-05-19T18:00:00+03:00\",\n    \"groupId\": \"0\",\n    \"accomplices\": [],\n    \"auditors\": [],\n    \"creator\": {\n      \"id\": \"1\",\n      \"name\": \"Текущий пользователь\",\n      \"link\": \"\u002Fcompany\u002Fpersonal\u002Fuser\u002F1\u002F\"\n    },\n    \"responsible\": {\n      \"id\": \"1\",\n      \"name\": \"Текущий пользователь\",\n      \"link\": \"\u002Fcompany\u002Fpersonal\u002Fuser\u002F1\u002F\"\n    }\n  }\n}\n```\n\n## Пример ответа при ошибке\n\n422 — не указан ответственный:\n\n```json\n{\n  \"success\": false,\n  \"error\": {\n    \"code\": \"BITRIX_ERROR\",\n    \"message\": \"Не указан исполнитель\"\n  }\n}\n```\n\n## Ошибки\n\n| HTTP | Код | Описание |\n|------|-----|---------|\n| 422 | `BITRIX_ERROR` | Битрикс24 отклонил создание задачи — например, не передано обязательное поле `title` или `responsibleId`, либо переданное значение отклонено порталом |\n| 400 | `READONLY_FIELD` | В теле запроса передано поле, доступное только на чтение (`id`, `dateStart`, `createdDate`, `changedDate`, `closedDate`, `activityDate`) |\n| 403 | `SCOPE_DENIED` | API-ключ не имеет скоупа `tasks` |\n| 401 | `TOKEN_MISSING` | API-ключ не имеет настроенных токенов |\n\nПолный список общих ошибок API — [Ошибки](\u002Fdocs\u002Ferrors).\n\n## Смотрите также\n\n- [Поля задачи](.\u002Ffields.md) — что можно передавать\n- [Получить задачу](.\u002Fget.md) — чтение деталей\n- [Обновить задачу](.\u002Fupdate.md) — изменить состояние или сроки\n- [Список задач](.\u002Flist.md) — поиск задач после создания\n- [Batch-запросы](\u002Fdocs\u002Fbatch) — массовое создание\n- [Лимиты и оптимизация](\u002Fdocs\u002Foptimization) — rate limits\n","2026-07-07",{}]