Changelog

Список обновлений в REST API Mailganer. Новые записи сверху.

30.09.2026​

Обновление метода: Отправка триггера на сегмент​

Метод теперь сразу возвращает ошибку, если список сегмента не входит в списки подписчиков триггера. Раньше в таком случае метод отвечал success, а письма не отправлялись.

Метод: POST /api/v2/segments/{segment_id}/send_trigger/

Что изменилось:

• Если список сегмента не входит в списки триггера, метод возвращает HTTP 400 и текст Please set the current site [номер списка] for the trigger [номер триггера]. Отправка не создаётся.
• Текст успешного ответа изменён с Trigger sent successfully! на Trigger queued for sending: отправка выполняется фоном.
• В data успешного ответа добавлены поля task_id (ID фоновой задачи, статус проверяется методом получения статуса задачи) и scheduled_at (время, на которое запланирована отправка).

Пример ответа при несовпадении списков:

{
  "status": "invalid",
  "error": ["Please set the current site [113276] for the trigger [10802]"]
}

Метод в справочнике

14.09.2026​

Новый метод: Создание шаблона​

Добавлен метод для создания HTML-шаблона письма в разделе «Шаблоны» личного кабинета. Вёрстка передаётся текстом, шаблон сразу доступен для редактирования в личном кабинете и для выбора при создании рассылки. В ответе возвращается ID шаблона, его можно передать в метод создания рассылки в параметре template_id.

Метод: POST /api/v2/template/

Ограничение: не больше 60 запросов в час на аккаунт.

curl --location 'https://mailganer.com/api/v2/template/' \
--header 'Content-Type: application/json' \
--header 'Authorization: CodeRequest your_api_key' \
--data-raw '{
    "name": "Письмо о доставке",
    "html": "<html><body><div>Здравствуйте, {{ name }}!</div><a href=\"{{unsubscribeUrl}}\">Отписаться</a></body></html>",
    "group_id": 641
}'

Пример ответа:

{
    "template_id": "3e28f835-b2e6-43f1-9e82-f263a4a4a4fb",
    "edit_url": "https://mailganer.com/app/custom-template/3e28f835-b2e6-43f1-9e82-f263a4a4a4fb/"
}

Метод в справочнике

04.05.2026​

Обновление метода: Получение информации о подписчиках​

В метод выгрузки подписчиков добавлена возможность получать число дней с последней активности подписчика (последнее открытие массовой рассылки или триггерного письма). Значение считается на момент выполнения запроса.

Метод: GET /api/v2/emails/

curl --location 'https://mailganer.com/api/v2/emails/?last_activity_days=1' \
--header 'Authorization: CodeRequest your_api_key'

Метод в справочнике

28.04.2026​

Новый метод: Отправка триггера на сегмент​

Добавлен метод для запуска триггерной рассылки на существующий сегмент. Два режима: с учётом условий триггера (когда отправить и время отправки) или немедленная отправка без учёта условий.

Метод: POST /api/v2/segments/{segment_id}/send_trigger/

curl --location 'https://mailganer.com/api/v2/segments/245611/send_trigger/' \
--header 'Content-Type: application/json' \
--header 'Authorization: CodeRequest your_api_key' \
--data-raw '{
    "trigger_id": 145674,
    "ignore_trigger_conditions": true
}'

Метод в справочнике

08.04.2026​

Обновление метода: Создание рассылки​

В метод создания рассылки можно одновременно передать HTML и AMP-версию письма. HTML-версия показывается в почтовых клиентах, которые не поддерживают AMP.

Метод: POST /api/v1/mailing/create/

curl --location 'https://mailganer.com/api/v1/mailing/create/' \
--form 'api_key="your_api_key"' \
--form 'theme="Тема письма"' \
--form 'name="Название рассылки"' \
--form 'segment_id="123456"' \
--form 'html-content="<html>... обычный HTML ...</html>"' \
--form 'amp-html-content="<html ⚡4email>... AMP-версия ...</html>"'

Метод в справочнике

31.03.2026​

Обновление метода: Получение информации о подписчиках​

Добавлен фильтр по дате подписки или импорта: параметры start_date и end_date.

curl --location 'https://mailganer.com/api/v2/emails/?start_date=2024-10-10&end_date=2025-10-10' \
--header 'Authorization: CodeRequest your_api_key'

Метод в справочнике

12.02.2026​

Новые методы: Скачивание отчётов​

Добавлено асинхронное скачивание списков, сегментов и отчётов по рассылкам в форматах CSV и XLSX.

Параметры POST /api/v2/tasks/emails_report:

Методы в справочнике

04.02.2026​

Обновление метода: Отправка триггера​

Раньше метод /api/v2/triggers/{trigger_id}/send/ отправлял письмо только от отправителя из настроек триггера. Теперь можно подставить любой подтверждённый имейл отправителя, имя при этом обязательно.

curl --location 'https://mailganer.com/api/v2/triggers/113292/send/' \
--header 'Content-Type: application/json' \
--header 'Authorization: CodeRequest your_api_key' \
--data-raw '{
    "email": "subscriber@example.com",
    "sender_email": "consultant@company.ru",
    "sender_name": "Иван Консультант"
}'

Метод в справочнике