Changelog

Список обновлений в API-документации Mailganer

14-09-2026

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

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

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

Параметры:

name (обязательный) — название шаблона, не больше 250 символов
html (обязательный) — HTML-вёрстка письма, размер не больше максимального размера письма для аккаунта, по умолчанию 2048 Кб
group_id (опциональный, int) — 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 (опциональный, int) — если передать значение 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

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

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

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

Параметры:
  • trigger_id (обязательный) — ID триггера
  • ignore_trigger_conditions (опциональный, bool) — если 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-часть используется как fallback для почтовых клиентов, не поддерживающих AMP.
пример запроса
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

Метод получения информации о подписчике: добавлен фильтр по дате подписки/импорта
пример запроса
https://mailganer.com/api/v2/emails/?start_date=2024-10-10&end_date=2025-10-10

12-02-2026

Скачивание отчётов через API

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

Методы:
Параметры для POST /api/v2/tasks/emails_report:

  • site_id — ID списка
  • segment_id — ID сегмента
  • mailing_id + mailing_report_type (general_report_type / clicks) — отчёт по рассылке
  • file_type — csv или xlsx
  • start_date, end_date (опционально, только для списка и сегмента)

04-02-2026

Метод отправки триггера: добавлена возможность указать отправителя

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

Параметры (опциональные):

  • sender_email — 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": "Иван Консультант"
}'