метод REST scope: crm

crm.activity.todo.add

Добавить универсальное дело

Кто может выполнять: пользователь с правом на редактирование элемента CRM, для которого добавляется дело

Описание

Метод crm.activity.todo.add добавляет универсальное дело в таймлайн.

Параметры

ownerTypeId integer обязательный

Идентификатор типа объекта CRM, к которому привязано дело, например 2 для сделки

ownerId integer обязательный

Идентификатор элемента CRM, к которому привязано дело, например, 1

deadline datetime обязательный

Крайний срок дела, например 2025-02-03T15:00:00

title string необязательный

Название дела, по умолчанию пустая строка

description string необязательный

Описание дела, по умолчанию пустая строка

responsibleId integer необязательный

Идентификатор пользователя, ответственного за дело, например 1

parentActivityId integer необязательный

Идентификатор дела в таймлайне, с которым можно связать создаваемое дело, например 888

pingOffsets array необязательный

Массив, который содержит целочисленные значения в минутах, позволяющие настроить время напоминания о деле. Например [0, 15] означает, что будет создано 2 напоминания, которые придут за 15 минут до крайнего срока и в момент, когда крайний срок наступит. По умолчанию пустой массив, без напоминаний

colorId string необязательный

Идентификатор цвета дела в таймлайне, например 1. Для выбора доступно 8 цветов, значения от 1 до 7 и цвет по умолчанию, если ничего не указано:

!Доступные цвета

Примеры запроса

curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"ownerTypeId":2,"ownerId":1,"deadline":"'"$(date -Iseconds)"'","title":"Заголовок дела","description":"Описание дела","responsibleId":5,"pingOffsets":[0,15],"colorId":"2"}' \
https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/crm.activity.todo.add

Ответ

HTTP-статус: 200

{
    "result": {
        "id": 999
    },
    "time": {
       "start": 1724068028.331234,
        "finish": 1724068028.726591,
        "duration": 0.3953571319580078,
        "processing": 0.13033390045166016,
        "date_start": "2025-01-21T13:47:08+02:00",
        "date_finish": "2025-01-21T13:47:08+02:00",
        "operating": 0
    }
}

Возвращаемые данные

result object

В случае успеха возвращает объект, содержащий идентификатор добавленного дела id, в случае ошибки = null

time time

Информация о времени выполнения запроса

Обработка ошибок

HTTP-статус: 400

{
    "error": "NOT_FOUND",
    "error_description": "Not found."
}
Код Описание Значение
100 Не переданы обязательные поля
NOT_FOUND Элемент CRM не найден
ACCESS_DENIED Недостаточно прав для выполнения операции
OWNER_NOT_FOUND Владелец элемента не найден
WRONG_DATETIME_FORMAT Некорректный формат даты

Что будем искать? Например,Продвижение

Этот сайт использует куки-файлы. Оставаясь на сайте, Вы соглашаетесь на их использование. Для получения дополнительной информации, пожалуйста, ознакомьтесь с политикой в отношении персональных данных.