Mailganer API

REST API Mailganer позволяет управлять подписчиками, списками, сегментами, рассылками, триггерами, отчётами и другими сущностями программно.

• Базовый адрес: https://mailganer.com
• Формат: JSON
• Полный справочник методов: Методы API — с примерами и схемами.
• Интерактивно попробовать: Try it (Swagger) — отправка запросов прямо из браузера.
• Postman: коллекция и инструкция по импорту — импортируется в Postman/Insomnia.
• Python: официальная библиотека, ставится командой pip install mailganer.
• Документация для ИИ: llms.txt и llms-full.txt для Cursor, Claude и ChatGPT.
• SMTP: отправка писем по SMTP описана отдельно, со своей авторизацией — документация SMTP.
• Старая документация: old-documentation.mailganer.ru — поддерживаем до конца 2026 года.

Быстрый старт

1. Скопируйте API-ключ в личном кабинете, раздел Ключ API.
2. Все v2-методы принимают ключ в заголовке — см. Авторизация.
3. Добавьте первого подписчика:

cURL

curl --location --request POST 'https://mailganer.com/api/v2/emails/' \
--header 'Authorization: CodeRequest ВАШ_API_КЛЮЧ' \
--header 'Content-Type: application/json' \
--data-raw '{
    "email": "test@example.com",
    "source": 49767
}'

Python

pip install mailganer

from mailganer import Mailganer

mg = Mailganer(api_key="ВАШ_API_КЛЮЧ")
mg.subscribers.add("test@example.com", source=49767)

Подробнее: Библиотека для Python.

Как устроена эта документация

Справочник методов генерируется автоматически из файла openapi.yaml — единого источника правды. Гайды (эта и соседние страницы) пишутся вручную в markdown.