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

Привязать CRM-объект

POST /v1/tasks/:taskId/bind-crm-item

Выполняет связь с CRM одним вызовом tasks.task.bindCrmItem. Нужны скоуп task (или tasks), ключ с разрешённой записью и права пользователя Битрикс24 на действие.

Параметры

Параметр	Где	Тип	Обязателен	Описание
`taskId`	path	integer	да	Положительный ID задачи из списка задач.
`crmItemId`	body	string	да	Непустая ссылка на CRM-объект, например `D_123`.

Примеры

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

Terminal

curl -X POST 'https://vibecode.bitrix24.tech/v1/tasks/289/bind-crm-item' \
  -H 'X-Api-Key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"crmItemId":"D_123"}'

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

Terminal

curl -X POST 'https://vibecode.bitrix24.tech/v1/tasks/289/bind-crm-item' \
  -H 'X-Api-Key: YOUR_APP_KEY' \
  -H 'Authorization: Bearer USER_SESSION_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{"crmItemId":"D_123"}'

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

javascript

const response = await fetch('https://vibecode.bitrix24.tech/v1/tasks/289/bind-crm-item', {
  method: 'POST',
  headers: {
    'X-Api-Key': 'YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({"crmItemId":"D_123"}),
})
const result = await response.json()
console.log(result.data)

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

javascript

const response = await fetch('https://vibecode.bitrix24.tech/v1/tasks/289/bind-crm-item', {
  method: 'POST',
  headers: {
    'X-Api-Key': 'YOUR_APP_KEY',
    'Authorization': 'Bearer USER_SESSION_TOKEN',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({"crmItemId":"D_123"}),
})
const result = await response.json()
console.log(result.data)

Ответ

Поле	Тип	Описание
`success`	boolean	`true` при успешном вызове.
`data`	any	Фактический результат метода Битрикс24 без преобразования: объект задачи, `null` или другое значение метода.

Пример ниже показывает одну допустимую форму ответа, а не гарантию null.

JSON

{"success":true,"data":{"success":true}}

Пример ошибки

Некорректный ID задачи в пути даёт 400:

JSON

{"success":false,"error":{"code":"INVALID_PARAMS","message":"taskId must be a positive integer"}}

Ошибки

HTTP	Код	Условие
400	`INVALID_PARAMS`	Некорректный `taskId` или поле тела.
401	`MISSING_API_KEY`	Нет API-ключа.
401	`INVALID_API_KEY`	Ключ не найден.
401	`TOKEN_MISSING`	Нет действующего токена Битрикс24.
403	`SCOPE_DENIED`	Нет скоупа `task` или `tasks`.
403	`WRITE_BLOCKED_READONLY_KEY`	Ключу запрещена запись.
403	`BITRIX_ACCESS_DENIED`	Битрикс24 отказал в доступе.
422	`BITRIX_ERROR`	Битрикс24 отклонил действие.

Другие ошибки общего API возможны. Проверяйте error.code; полный справочник ошибок.

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

Задачи