Changelog

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

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 — создание задачи
GET /api/v2/tasks/<task_id> - статус задачи
GET /api/v2/tasks/<task_id>/download_file — скачивание файла

Параметры для 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": "Иван Консультант"
}'