Перейти к основному содержимому

Подписка с сайта или из CRM

Покупатель оставил почту в форме, зарегистрировался или оформил заказ: ваша система передаёт адрес в Mailganer вместе с именем, телефоном и своими полями. Дальше по нему работают рассылки и триггеры.

1. Что понадобится​

  • ID списка, куда добавлять подписчиков. Он есть в настройках списков.
  • Свои поля, например дата последней покупки или номер карты лояльности, заводятся как пользовательские переменные: в настройках списка или методом POST /api/v2/user_vars/.

2. Запрос​

POST /api/v2/emails/:

curl --location 'https://mailganer.com/api/v2/emails/' \
--header 'Authorization: CodeRequest ВАШ_API_КЛЮЧ' \
--header 'Content-Type: application/json' \
--data-raw '{
    "email": "buyer@example.com",
    "source": 49767,
    "name": "Анна",
    "phone": "+79123456789",
    "add_tag": "форма в футере",
    "user_vars": {"last_order": "05.10.2026"}
}'

В ответе придут id и mg_hash подписчика и его статус в email_status.

Отправляйте запрос со своего сервера. Ключ API нельзя класть в код страницы: по нему доступен весь аккаунт.

Подтверждение подписки​

По умолчанию новый адрес получает статус "Запрошено подтверждение" и письмо со ссылкой. Рассылки начнут приходить после клика. Повторно письмо подтверждения можно отправить не раньше чем через час.

Если согласие вы уже получили у себя, например галочкой при оформлении заказа, передайте "not_doi": true: подписчик сразу станет активным. Параметр подключает поддержка.

Обновление данных​

Изменились имя, телефон или переменная: PATCH /api/v2/emails/update/ с теми же email и source. Передаются только поля, которые меняются. Значение null в user_vars удаляет переменную.

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

Много адресов сразу​

В тот же POST /api/v2/emails/ можно передать массив до 50 подписчиков. Если в одном из них ошибка, не добавится ни один, поэтому проверяйте ответ. При ответе 503 повторите запрос чуть позже. Лимит: 500 запросов в минуту.