Добавление нового подписчика
POST https://mailganer.com/api/v2/emails/
Список параметров запроса (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"],
        ...
    }
}
Возможные ошибки
Написать в поддержку
Mail