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

To-do дела CRM

Новые дела типа CRM_TODO создаются и обновляются здесь. Чтение и список остаются в делах CRM: используйте GET /v1/activities/:id или список с фильтром providerId=CRM_TODO.

Скоуп: crm. Для записи нужен ключ с режимом записи. Все ответы о деле имеют ту же форму, что GET /v1/activities/:id.

Создать to-do

POST /v1/activity-todos вызывает crm.activity.todo.add.

JSON

{"ownerTypeId":2,"ownerId":123,"deadline":"2026-10-01T12:00:00Z","title":"Проверить договор","description":"Позвонить клиенту"}

ownerTypeId, ownerId, deadline обязательны. Дополнительно доступны title, description, responsibleId, parentActivityId, pingOffsets (целые минуты, не меньше нуля) и colorId (default, 1–7). settings, fileTokens, isCopy не принимаются.

parentActivityId связывает новое дело с существующим и Битрикс24 автоматически завершает родительское дело. Родитель должен быть привязан к тому же владельцу CRM. Если привязка изменится во время создания, ответ 422 содержит error.createdId уже созданного дела; проверьте также состояние родителя.

Успех: HTTP 201, { "success": true, "data": <дело> }. Дело перечитывается после создания. Если перечитать его не удалось, 502 ACTIVITY_CREATED_READ_FAILED содержит error.createdId: проверьте созданное дело перед повторным POST. Неизвестный родитель, цвет вне палитры и неверные пинги отвергаются до вызова создания.