Для AI-агентов: markdown этой страницы — /docs-content/entities/deal-categories/create.md индекс документации — /llms.txt

Создать воронку

POST /v1/deal-categories

Создаёт новую воронку сделок. После создания добавьте стадии через справочники с entityId = DEAL_STAGE_{id}.

Параметры тела запроса

Параметр Тип Обязат. Описание
name string да Название воронки
sort number Порядок сортировки

Примеры

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

Terminal 
curl -X POST "https://vibecode.bitrix24.tech/v1/deal-categories" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "Корпоративные продажи", "sort": 200}'

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

Terminal 
curl -X POST "https://vibecode.bitrix24.tech/v1/deal-categories" \
  -H "X-Api-Key: YOUR_APP_KEY" \
  -H "Authorization: Bearer USER_SESSION_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name": "Корпоративные продажи", "sort": 200}'

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

javascript 
const res = await fetch('https://vibecode.bitrix24.tech/v1/deal-categories', {
  method: 'POST',
  headers: { 'X-Api-Key': 'YOUR_API_KEY', 'Content-Type': 'application/json' },
  body: JSON.stringify({ name: 'Корпоративные продажи', sort: 200 }),
})
const { success, data } = await res.json()

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

javascript 
const res = await fetch('https://vibecode.bitrix24.tech/v1/deal-categories', {
  method: 'POST',
  headers: {
    'X-Api-Key': 'YOUR_APP_KEY',
    'Authorization': 'Bearer USER_SESSION_TOKEN',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({ name: 'Корпоративные продажи', sort: 200 }),
})
const { success, data } = await res.json()

Поля ответа

Поле Тип Описание
success boolean Всегда true при успехе
data object Созданная воронка со всеми полями
data.id number ID воронки
data.name string Название
data.sort number Сортировка
data.isLocked boolean Заблокирована ли воронка — недоступна на текущем тарифе
data.createdAt datetime Дата создания

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

JSON 
{
  "success": true,
  "data": {
    "id": 5,
    "createdAt": "2026-06-01T10:00:00.000Z",
    "name": "Оптовые продажи",
    "sort": 200,
    "isLocked": false
  }
}

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

422 — не передано название name:

JSON 
{
  "success": false,
  "error": { "code": "BITRIX_ERROR", "message": "Field 'NAME' is required." }
}

Ошибки

HTTP Код Описание
422 BITRIX_ERROR Не передан name — сообщение Field 'NAME' is required.
422 BITRIX_ERROR Прочие отказы Битрикс24 — причина в message
403 SCOPE_DENIED API-ключ не имеет скоупа crm
401 MISSING_API_KEY Не передан заголовок X-Api-Key

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

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