метод REST scope: mail

mail.message.thread

Получить цепочку писем

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

Описание

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

Метод mail.message.thread возвращает цепочку писем по идентификатору одного письма.

Параметры

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

Идентификатор любого письма из цепочки.

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

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

Максимальное количество писем в ответе.

По умолчанию — 20, максимум — 50

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

curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"id":15,"limit":20}' \
https://**put_your_bitrix24_address**/rest/api/**put_your_user_id_here**/**put_your_webhook_here**/mail.message.thread

Ответ

HTTP-статус: 200

{
    "result": [
        {
            "id": 15,
            "subject": "Договор поставки",
            "from": "Иван Петров <ivan.petrov@example.com>",
            "to": "manager@example.com",
            "cc": "",
            "date": "2026-05-26 12:17:35",
            "body": "Добрый день! Направляю проект договора."
        },
        {
            "id": 16,
            "subject": "Re: Договор поставки",
            "from": "manager@example.com",
            "to": "Иван Петров <ivan.petrov@example.com>",
            "cc": "",
            "date": "2026-05-27 12:17:35",
            "body": "Здравствуйте! Спасибо, получили, изучим и вернемся с комментариями."
        }
    ],
    "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 array

Список писем из цепочки

result[] object

Объект письма из цепочки

id integer

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

subject string

Тема письма

from string

Отправитель письма

to string

Получатель письма

cc string

Получатели копии

date string

Дата и время письма

body string

Текст письма

time time

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

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

HTTP-статус: 400

{
    "error": {
        "code": "BITRIX_REST_V3_EXCEPTION_ENTITYNOTFOUNDEXCEPTION",
        "message": "Запись с ID = `15` не найдена"
    }
}
Код Описание Значение
Поле Описание ошибки Как исправить
id Обязательное поле id не указано Добавьте id в тело запроса

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

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