Перейти к основному содержимому

Changelog

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

14.09.2026​

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

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

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

ПараметрТипОбязательныйОписание
nameстрокадаНазвание шаблона, не больше 250 символов
htmlстрокадаHTML-вёрстка письма. Размер не больше максимального размера письма для аккаунта, по умолчанию 2048 Кб
group_idчислонетID группы шаблонов. Если не передан, шаблон создаётся без группы

Ограничение: не больше 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/

ПараметрТипОбязательныйОписание
last_activity_daysчислонетЕсли передать 1, в объекте каждого подписчика вернётся поле last_activity_info: число дней с последней активности или null, если активности не было
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/

ПараметрТипОбязательныйОписание
trigger_idчислодаID триггера
ignore_trigger_conditionsboolнетЕсли true, письма уходят сразу, условия триггера не учитываются
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Создаёт задачу на формирование отчёта
GET /api/v2/tasks/{task_id}Возвращает статус задачи
GET /api/v2/tasks/{task_id}/download_fileСкачивает готовый файл

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

ПараметрОписание
site_idID списка
segment_idID сегмента
mailing_id + mailing_report_typeОтчёт по рассылке: general_report_type или clicks
file_typecsv или xlsx
start_date, end_dateНеобязательные, только для списка и сегмента

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

04.02.2026​

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

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

ПараметрТипОбязательныйОписание
sender_emailстроканетИмейл отправителя, должен быть подтверждён и привязан к аккаунту
sender_nameстрокаесли передан sender_emailИмя отправителя
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": "Иван Консультант"
}'

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