Добавление нового подписчика

POST https://mailganer.com/api/v2/emails/

Рекомендуем использовать API v3.

Метод /api/v3/emails/ возвращает детализированный ответ по каждой записи. В ответе успешные операции будут перечислены в массиве successful, а записи с ошибками в массиве failed. Пример детализированного ответа можно посмотреть ниже в документации.

Список параметров запроса (json)

Уточнения по параметрам add_tag и add_category
"add_tag": "tag1, tag2" - Подписчику будет добавлено 2 тега: tag1, tag2
"add_tag": ["tag1, tag2"] - Аналогичное поведение с первым кейсом
"add_tag": ["tag1", "tag2, tag3"] - Будет добавлено 3 тега: tag1, tag2, tag3

Имейл добавляется в статусе Запрошено подтверждение и на имейл отправится письмо с подтверждением подписки. Полезная статья: Как изменить стандартное письмо-подтверждение подписки. Когда подписчик кликнет по ссылке из письма подтверждения, статус изменится на Активен. Параметры not_doi и need_activate по-умолчанию не работают, запросите их активацию в поддержке.

Если подписчик есть в списке в статусе ОТПИСАЛСЯ при передаче параметра not_doi: true/1 у подписчика меняется статус на АКТИВНЫЙ
Если подписчик в статусе в списке в статусе НЕДОСТУПЕН, при передаче параметра not_doi: true/1 у подписчика не меняется статус

Пример запроса (json)

{
    "email": "test@example.com",
    "source": 49767, // [49767,50145] - для добавления в несколько списков, all - для добавления во все списки
    "phone": "+79123456789",
    "name": "Федор",
    "patronymic": "Федорович",
    "surname": "Федоров",
    "gender": 1,
    "birthday": "01.01.1988",
    "add_tag": "метка1",
    "delete_tag": "метка2",
    "add_category": "Категория1",
    "delete_category": "Категория2",
    "user_vars": {
        "text": "Текст", // строковый тип переменной
        "integer": 12, // целое число
        "float": 12.5, // вещественное число
        "date": "01.01.1971", // дата
        "dateTime": "01.01.1971 11:00:00", // дата и время
        "boolean": true, // логический
        "goods": [ // json-массив
            {"name": "Apple iPhone X", "price": 54000}, 
            {"name": "Samsung Galaxy S21", "price": 64000}
        ]
    }
}

Список параметров ответа в случае успеха (json)

Возможные значения статусов подписчика

Примеры ответов

В случае успеха

{
    "id": 45763880,
    "mg_hash": "53158545763880e054b31ecbad2cf3265d4001d1",
    "email_status": "fixed", // статус подписчика подробно описан в таблице ниже
    "bunce_log": "mailbox size limit exceeded", // причина несуществования имейла для статуса not_available
    "corrected_email": "test@mail.ru", // для статуса fixed передаётся новый имейл, если исправлена опечатка
}

В случае ошибки

{
    "status": "invalid",
    "error": {
        "source": ["Not found site (source_id=497671) or site blocked"],
        "birthday": ["Неправильный формат date. Используйте формат: DD.MM.YYYY"],
        ...
    }
}

{
    "status": "invalid",
    "error": [
        "Название тега не должно превышать 140 символов."
    ]
}

Возможные ошибки

Детализированный ответ (JSON)

В этом ответе возвращается массив successful (адреса добавлены успешно) и failed (адреса не добавлены).

Детализированный ответ активируется через запрос в поддержку

{
    "successful": [
        {
            "id": 325280336,
            "mg_hash": "e221e83252803364563bfda200a",
            "email": "test@gmail.com",
            "source": 1048,
            "email_status": "active",
            "corrected_email": null,
            "name": "",
            "patronymic": "",
            "surname": "",
            "gender": 0,
            "birthday": null,
            "phone": null,
            "city": null,
            "country": null,
            "is_valid": false,
            "doi_is_delivery": false,
            "doi_is_open": false,
            "doi_is_click": false,
            "user_vars": {
                "date_glob": null,
                "glob": null,
                "globalnayatest1": null,
                "str_glob_2": null
            },
            "bunce_log": null,
            "tags": [
                "желтый"
            ],
            "categories": [],
            "created": "2026-04-08T12:48:15.302810",
            "modified": "2026-04-08T12:55:33.550935"
        }
    ],
    "failed": []
}