метод REST scope: mail

mail.message.createtask

Создать задачу из письма

Кто может выполнять: пользователь с доступом к почтовому ящику, где находится письмо

Описание

Метод относится к REST 3.0. Особенности вызова и формат ответа новой версии API описаны в обзоре REST 3.0.

Метод mail.message.createtask создает задачу из письма.

Параметры

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

Идентификатор письма.

Идентификатор можно получить методом mail.message.list

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

Название задачи.

Если не передано, используется тема письма

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

Идентификатор ответственного.

Если не передан, используется текущий пользователь

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

Описание задачи

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

curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"messageId":15,"title":"Подготовить договор","responsibleId":7}' \
https://**put_your_bitrix24_address**/rest/api/**put_your_user_id_here**/**put_your_webhook_here**/mail.message.createtask

Ответ

HTTP-статус: 200

{
    "result": {
        "success": true,
        "taskId": 42,
        "messageId": 15
    },
    "time": {
        "start": 1779819678,
        "finish": 1779819678.84803,
        "duration": 0.8480300903320312,
        "processing": 0,
        "date_start": "2026-05-26T21:21:18+03:00",
        "date_finish": "2026-05-26T21:21:18+03:00",
        "operating_reset_at": 1779820278,
        "operating": 0
    }
}

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

result object

Объект с результатом выполнения операции

success boolean

Признак успешного выполнения операции

taskId integer

Идентификатор созданной задачи

messageId integer

Идентификатор исходного письма

time time

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

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

HTTP-статус: 400

{
    "error": {
        "code": "BITRIX_REST_V3_EXCEPTION_VALIDATION_REQUESTVALIDATIONEXCEPTION",
        "message": "Ошибка при валидации объекта запроса",
        "validation": [
            {
                "message": "Обязательное поле `messageId` не указано",
                "field": "messageId"
            }
        ]
    }
}
Код Описание Значение
Поле Описание ошибки Как исправить
messageId Обязательное поле messageId не указано или передано некорректное значение Передайте messageId как положительное целое число больше 0
Module tasks is not installed. Установите и настройте модуль задач
messageId Сообщение удалено или перемещено в другую папку Проверьте, что письмо существует и доступно текущему пользователю
Не удалось создать задачу Проверьте права доступа к задачам и корректность параметров

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

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