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

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

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

[
    {
        "email": "test@example.com",
        "source": 85760,
        "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": [
                {"name": "Apple iPhone X", "price": 54000},
                {"name": "Samsung Galaxy S21", "price": 64000}
            ]
        }
    },
    {
        "email": "test2@example.com",
        "source": 85760,
        "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": [
                {"name": "Apple iPhone X", "price": 54000},
                {"name": "Samsung Galaxy S21", "price": 64000}
            ]
        }
    }
]
Можно передать массив до 50 имейлов.
Если хотя бы в одном имейле будет ошибка, то ни один имейл из пакета не добавится.

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

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

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

[
    {
        "id": 45764030,
        "mg_hash": "100330457640309ee63894dced455d110aebcb2b",
        "in_base": true,
        "email_status": "active"
    },
    {
        "id": 45764025,
        "mg_hash": "e031e245764025457cb340b96fd670419cf95bb2",
        "in_base": false,
        "email_status": "wait_activated"
    }
]

Пример ответа в случае ошибки (json)

{
    "status": "invalid",
    "error": [
        {},
        {
            "source": ["Not found site (source_id=497672) or site blocked"]
        }
    ]
}

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

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

Детализированный ответ активируется через запрос в поддержку
{
    "successful": [
        {
            "id": 2803521837,
            "mg_hash": "58dbe0280456837f2062d3be345242232d9d9cc402511",
            "email": "test1@example.com",
            "source": 88546,
            "email_status": "wait_activated",
            "corrected_email": "test1@example.com",
            "name": "Федор",
            "patronymic": "Федорович",
            "surname": "Федоров",
            "gender": 1,
            "birthday": "01.01.1988",
            "phone": null,
            "city": null,
            "country": null,
            "is_valid": false,
            "doi_is_delivery": false,
            "doi_is_open": false,
            "doi_is_click": false,
            "user_vars": {},
            "bunce_log": null,
            "tags": [],
            "categories": []
        },
        {
            "id": 2803521837,
            "mg_hash": "58dbe0280456837f2062d3be345242232d9d9cc402511",
            "email": "test2@example.com",
            "source": 88523,
            "email_status": "not_available",
            "corrected_email": null,
            "name": "Пётр",
            "patronymic": "Петрович",
            "surname": "Петров",
            "gender": 1,
            "birthday": "01.01.1988",
            "phone": null,
            "city": null,
            "country": null,
            "is_valid": false,
            "doi_is_delivery": false,
            "doi_is_open": false,
            "doi_is_click": false,
            "user_vars": {},
            "bunce_log": "User stop list email hash: 04665f235633226bc59ca14ab38bf167ec9ff5941",
            "tags": [],
            "categories": []
        }
    ],
    "failed": [
        {
            "errors": {
                "source": [
                    "Not found site (source=[51488]) or site blocked"
                ]
            },
            "email": "test3@example.com"
        }
    ]
}