#Создать задачу

POST /v1/tasks

Создаёт новую задачу. Минимум — название и ответственный.

#Поля запроса (body)

Поле Тип Обяз. Описание
title string ★ Название задачи
responsibleId number ★ Ответственный. Список сотрудников: GET /v1/users
description string Описание задачи. Поддерживает BB-код ([USER=ID]Имя[/USER], [B]...[/B], [QUOTE]...[/QUOTE])
priority number Приоритет: 0 — низкий, 1 — обычный (по умолчанию), 2 — высокий
status number Статус. По умолчанию 2 (ждёт выполнения). Полный список значений: GET /v1/tasks/fields → fields.status.enum
deadline datetime Крайний срок (ISO 8601)
startDatePlan datetime Плановая дата начала
endDatePlan datetime Плановая дата окончания
timeEstimate number Оценка трудозатрат в секундах
groupId number Рабочая группа. Список: GET /v1/workgroups
parentId number Родительская задача. Список: GET /v1/tasks
accomplices number[] Соисполнители. Список сотрудников: GET /v1/users
auditors number[] Наблюдатели. Список сотрудников: GET /v1/users
tags string[] Метки задачи

Полный список полей — `GET /v1/tasks/fields`. Поля id, createdBy, createdDate, changedDate, closedDate заполняются системой и в body не передаются.

#Примеры

#curl — личный ключ

Terminal 
curl -X POST "https://vibecode.bitrix24.tech/v1/tasks" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Подготовить отчёт за квартал",
    "responsibleId": 1,
    "priority": 2,
    "deadline": "2026-05-19T18:00:00+03:00"
  }'

#curl — OAuth-приложение

Terminal 
curl -X POST "https://vibecode.bitrix24.tech/v1/tasks" \
  -H "X-Api-Key: YOUR_APP_KEY" \
  -H "Authorization: Bearer USER_SESSION_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Подготовить отчёт за квартал",
    "responsibleId": 1,
    "priority": 2,
    "deadline": "2026-05-19T18:00:00+03:00"
  }'

#JavaScript — личный ключ

javascript 
const res = await fetch('https://vibecode.bitrix24.tech/v1/tasks', {
  method: 'POST',
  headers: {
    'X-Api-Key': 'YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    title: 'Подготовить отчёт за квартал',
    responsibleId: 1,
    priority: 2,
    deadline: '2026-05-19T18:00:00+03:00',
  }),
})

const { success, data } = await res.json()
console.log('ID новой задачи:', data.id)

#JavaScript — OAuth-приложение

javascript 
const res = await fetch('https://vibecode.bitrix24.tech/v1/tasks', {
  method: 'POST',
  headers: {
    'X-Api-Key': 'YOUR_APP_KEY',
    'Authorization': 'Bearer USER_SESSION_TOKEN',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    title: 'Подготовить отчёт за квартал',
    responsibleId: 1,
    priority: 2,
    deadline: '2026-05-19T18:00:00+03:00',
  }),
})

const { success, data } = await res.json()

#Поля ответа

Поле Тип Описание
success boolean Всегда true при успехе
data object Полный объект созданной задачи (как у GET /v1/tasks/:id) — см. Поля задачи

#Пример ответа

JSON 
{
  "success": true,
  "data": {
    "id": "3871",
    "title": "Подготовить отчёт за квартал",
    "description": "",
    "status": "2",
    "priority": "2",
    "responsibleId": "1",
    "createdBy": "1",
    "createdDate": "2026-05-12T11:46:12+03:00",
    "deadline": "2026-05-19T18:00:00+03:00",
    "groupId": "0",
    "accomplices": [],
    "auditors": [],
    "creator": {
      "id": "1",
      "name": "Текущий пользователь",
      "link": "/company/personal/user/1/"
    },
    "responsible": {
      "id": "1",
      "name": "Текущий пользователь",
      "link": "/company/personal/user/1/"
    }
  }
}

#Пример ответа при ошибке

400 — не указан ответственный:

JSON 
{
  "success": false,
  "error": {
    "code": "BITRIX_ERROR",
    "message": "Не указан исполнитель"
  }
}

#Ошибки

HTTP Код Описание
400 BITRIX_ERROR Не передано обязательное поле (title, responsibleId) или поле содержит недопустимое значение
400 READONLY_FIELD В теле запроса передано поле, доступное только на чтение (id, createdBy, createdDate, changedDate, closedDate)
403 SCOPE_DENIED API-ключ не имеет скоупа tasks
401 TOKEN_MISSING API-ключ не имеет настроенных токенов

Полный список общих ошибок API — Ошибки.

#Смотрите также