{"info":{"_postman_id":"ad2a6101-55ec-46be-9158-ec0369852183","name":"REST API Mailganer","description":"

Методы поделены на несколько групп:
1. Работа с личным кабинетом Mailganer. Стандартные методы по работе с подписчикам, списками, рассылками.
2. Интеграция Mailganer со сторонними приложениями. Группа методов называется \"Работа с пользователями\"

Напишите нам на api@mailganer.com, если вам не хватает какого то метода.

Методы по работе с SMTP задокументированы отдельно и имеют свою отдельную авторизацию

Авторизация

1. В методах, содержащих в url v1, авторизация происходит через использование апи ключа в теле запроса в переменной api_key.
2. В методах, содержащих в url v2, авторизация происходит через использование апи ключа в заголовке Authorization: CodeRequest {{api_key}}

API ключ находится в разделе Мои данные

Лимиты

К API можно обращаться не чаще 500 раз в минуту. В случае превышения лимита, вы получите ошибку с кодом 429. Напишите нам, если требуется увеличить лимит.

Пагинация

Некоторые методы отдают по 25 записей на странице. В переменной count находится количество записей. Ответ находится в json-масиве result. В переменных next и previous находятся ссылки на следующую или предыдущую страницы. Если следующей или предыдущей страницы нет, то вернётся значение null.

{\n    \"count\": 2,\n    \"next\": null,\n    \"previous\": null,\n    \"results\": [\n        {\n            \"source\": 1,\n            \"title\": \"user_var_float\",\n            \"type\": 2,\n            \"type_text\": \"Вещественное число\"\n        },\n        {\n            \"source\": 1,\n            \"title\": \"user_var_datetime\",\n            \"type\": 4,\n            \"type_text\": \"Дата и время\"\n        }\n    ]\n}\n\n

\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"23131434","collectionId":"ad2a6101-55ec-46be-9158-ec0369852183","publishedId":"VUxPvnhA","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"656565","highlight":"2980b9"},"publishDate":"2022-12-09T09:48:32.000Z"},"item":[{"name":"Подписчики","item":[{"name":"Добавление нового подписчика","id":"e8ea5497-5c36-491e-8357-338b485a40be","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"email\": \"test@example.com\",\n \"source\": 49767, // [49767,50145] - для добавления в несколько списков, \"all\" - для добавления во все списки\n \"phone\": \"+79123456789\",\n \"name\": \"Федор\",\n \"patronymic\": \"Федорович\",\n \"surname\": \"Федоров\",\n \"gender\": 1,\n \"birthday\": \"01.01.1988\",\n \"add_tag\": \"метка1\",\n \"delete_tag\": \"метка2\",\n \"user_vars\": {\n \"text\": \"Текст\", // строковый тип переменной\n \"integer\": 12, // целое число\n \"float\": 12.5, // вещественное число\n \"date\": \"01.01.1971\", // дата\n \"dateTime\": \"01.01.1971 11:00:00\", // дата и время\n \"boolean\": true, // логический\n \"goods\": [ // json-массив\n {\"name\": \"Apple iPhone X\", \"price\": 54000}, \n {\"name\": \"Samsung Galaxy S21\", \"price\": 64000}\n ]\n }\n}","options":{"raw":{"language":"json"}}},"url":"https://mailganer.com/api/v2/emails/","description":"

Добавляет нового подписчика в указанный список (или списки).

Эндпоинт: POST https://mailganer.com/api/v2/emails/\nАвторизация: заголовок Authorization: CodeRequest {{api_key}} (наследуется от коллекции)\nContent-Type: application/json

Обязательные поля

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Поле	Тип	Описание
`email`	string	Имейл подписчика
`source`	int / array / `\"all\"`	ID списка. `\"all\"` — во все списки; можно передать массив ID

Необязательные поля

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Поле	Тип	Описание
`phone`	string	Телефон
`name`, `surname`, `patronymic`	string	ФИО
`gender`	int	1 — мужской, 2 — женский
`birthday`	string	Дата рождения, формат `dd.mm.yyyy`
`city`	string	Город
`add_tag` / `delete_tag`	string / array	Добавить / удалить метку (≤ 140 символов)
`add_category` / `delete_category`	string	Добавить / удалить категорию (≤ 250 символов)
`user_vars`	object	Пользовательские переменные (`null` в значении — удалить его)
`not_doi` / `need_activate`	bool	Управление DOI (требует активации поддержкой)

Пример curl

curl --location --request POST 'https://mailganer.com/api/v2/emails/' \\\n--header 'Authorization: CodeRequest {{api_key}}' \\\n--header 'Content-Type: application/json' \\\n--data-raw '{\n    \"email\": \"test@example.com\",\n    \"source\": 49767\n}'\n

Примечания

Лимит: 500 запросов/мин, иначе 429.
Ошибка 400 «We have already sent a subscription confirmation email…» — повторное DOI-письмо доступно через 1 час.
Рекомендуется v3 (/api/v3/emails/) — детальный ответ с массивами successful / failed.

📄 Документация: https://documentation.mailganer.ru/documentation/email/add

Обновляет информацию о подписчике, идентифицируя его по хэшу имейла (mg_hash) в URL.

Эндпоинт: PATCH https://mailganer.com/api/v2/emails/:email_hash/\nАвторизация: заголовок Authorization: CodeRequest {{api_key}} (наследуется от коллекции)\nContent-Type: application/json

Подписчик определяется по mg_hash в пути (path-переменная email_hash), поэтому передавать email и source в теле не требуется — в теле указываются только обновляемые поля.

Тело запроса

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Поле	Тип	Обяз.	Описание
`phone`	string	нет	Телефон
`name`	string	нет	Имя
`surname`	string	нет	Фамилия
`patronymic`	string	нет	Отчество
`gender`	int	нет	1 — мужской, 2 — женский
`birthday`	string	нет	Дата рождения, формат `dd.mm.yyyy`
`city`	string	нет	Город
`add_tag`	string / array	нет	Добавить метку
`delete_tag`	string	нет	Удалить метку
`user_vars`	object	нет	Пользовательские переменные (передайте `null` в значении, чтобы удалить переменную)
`not_doi`	bool	нет	Отменить отправку письма подтверждения
`need_activate`	bool	нет	Отправить письмо подтверждения
`add_category`	string	нет	Добавить категорию подписки
`delete_category`	string	нет	Удалить категорию подписки

Пример curl

curl --location --request PATCH 'https://mailganer.com/api/v2/emails/a05ad557332370764cd4f267a251f3b13289bcff/' \\\n--header 'Authorization: CodeRequest {{api_key}}' \\\n--header 'Content-Type: application/json' \\\n--data-raw '{\n    \"birthday\": \"02.01.1990\"\n}'\n

Примечания

Переменные (user_vars) обновляются только если явно переданы в запросе.
Чтобы удалить значение пользовательской переменной, передайте null — работает для всех типов переменных.
Альтернативные способы обновления: эндпоинт /api/v2/emails/update/ (передача email + source в теле) или массовое обновление /api/v2/emails/mass/.

📄 Документация: https://documentation.mailganer.ru/documentation/email/update

Хэш имейла

\n","type":"text/plain"},"type":"any","value":"a05ad557332370764cd4f267a251f3b13289bcff","key":"email_hash"}]}},"response":[{"id":"4fa1b714-68cf-46f8-5243-7f70accc80da","name":"Успех (200)","originalRequest":{"method":"PATCH","header":[{"value":"application/json","key":"Content-Type"}],"body":{"mode":"raw","raw":"{\n \"birthday\": \"02.01.1990\"\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"https://mailganer.com/api/v2/emails/:email_hash/","protocol":"https","host":["mailganer","com"],"path":["api","v2","emails",":email_hash",""],"variable":[{"key":"email_hash","value":"a05ad557332370764cd4f267a251f3b13289bcff","description":"Хэш имейла"}]},"description":"Обновляет информацию о подписчике, идентифицируя его по хэшу имейла (`mg_hash`) в URL.\n\n**Эндпоинт:** `PATCH https://mailganer.com/api/v2/emails/:email_hash/`\n**Авторизация:** заголовок `Authorization: CodeRequest {{api_key}}` (наследуется от коллекции)\n**Content-Type:** `application/json`\n\nПодписчик определяется по `mg_hash` в пути (path-переменная `email_hash`), поэтому передавать `email` и `source` в теле не требуется — в теле указываются только обновляемые поля.\n\n### Тело запроса\n| Поле | Тип | Обяз. | Описание |\n|---|---|---|---|\n| `phone` | string | нет | Телефон |\n| `name` | string | нет | Имя |\n| `surname` | string | нет | Фамилия |\n| `patronymic` | string | нет | Отчество |\n| `gender` | int | нет | 1 — мужской, 2 — женский |\n| `birthday` | string | нет | Дата рождения, формат `dd.mm.yyyy` |\n| `city` | string | нет | Город |\n| `add_tag` | string / array | нет | Добавить метку |\n| `delete_tag` | string | нет | Удалить метку |\n| `user_vars` | object | нет | Пользовательские переменные (передайте `null` в значении, чтобы удалить переменную) |\n| `not_doi` | bool | нет | Отменить отправку письма подтверждения |\n| `need_activate` | bool | нет | Отправить письмо подтверждения |\n| `add_category` | string | нет | Добавить категорию подписки |\n| `delete_category` | string | нет | Удалить категорию подписки |\n\n### Пример curl\n```bash\ncurl --location --request PATCH 'https://mailganer.com/api/v2/emails/a05ad557332370764cd4f267a251f3b13289bcff/' \\\n--header 'Authorization: CodeRequest {{api_key}}' \\\n--header 'Content-Type: application/json' \\\n--data-raw '{\n \"birthday\": \"02.01.1990\"\n}'\n```\n\n### Примечания\n- Переменные (`user_vars`) обновляются только если явно переданы в запросе.\n- Чтобы удалить значение пользовательской переменной, передайте `null` — работает для всех типов переменных.\n- Альтернативные способы обновления: эндпоинт `/api/v2/emails/update/` (передача `email` + `source` в теле) или массовое обновление `/api/v2/emails/mass/`.\n\n📄 Документация: https://documentation.mailganer.ru/documentation/email/update"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"id\": 45763880,\n \"mg_hash\": \"53158545763880e054b31ecbad2cf3265d4001d1\"\n}"},{"id":"cbf1aef3-4928-30f6-aade-8001ede312a1","name":"Ошибка (400)","originalRequest":{"method":"PATCH","header":[{"value":"application/json","key":"Content-Type"}],"body":{"mode":"raw","raw":"{\n \"birthday\": \"02.01.1990\"\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"https://mailganer.com/api/v2/emails/:email_hash/","protocol":"https","host":["mailganer","com"],"path":["api","v2","emails",":email_hash",""],"variable":[{"key":"email_hash","value":"a05ad557332370764cd4f267a251f3b13289bcff","description":"Хэш имейла"}]},"description":"Обновляет информацию о подписчике, идентифицируя его по хэшу имейла (`mg_hash`) в URL.\n\n**Эндпоинт:** `PATCH https://mailganer.com/api/v2/emails/:email_hash/`\n**Авторизация:** заголовок `Authorization: CodeRequest {{api_key}}` (наследуется от коллекции)\n**Content-Type:** `application/json`\n\nПодписчик определяется по `mg_hash` в пути (path-переменная `email_hash`), поэтому передавать `email` и `source` в теле не требуется — в теле указываются только обновляемые поля.\n\n### Тело запроса\n| Поле | Тип | Обяз. | Описание |\n|---|---|---|---|\n| `phone` | string | нет | Телефон |\n| `name` | string | нет | Имя |\n| `surname` | string | нет | Фамилия |\n| `patronymic` | string | нет | Отчество |\n| `gender` | int | нет | 1 — мужской, 2 — женский |\n| `birthday` | string | нет | Дата рождения, формат `dd.mm.yyyy` |\n| `city` | string | нет | Город |\n| `add_tag` | string / array | нет | Добавить метку |\n| `delete_tag` | string | нет | Удалить метку |\n| `user_vars` | object | нет | Пользовательские переменные (передайте `null` в значении, чтобы удалить переменную) |\n| `not_doi` | bool | нет | Отменить отправку письма подтверждения |\n| `need_activate` | bool | нет | Отправить письмо подтверждения |\n| `add_category` | string | нет | Добавить категорию подписки |\n| `delete_category` | string | нет | Удалить категорию подписки |\n\n### Пример curl\n```bash\ncurl --location --request PATCH 'https://mailganer.com/api/v2/emails/a05ad557332370764cd4f267a251f3b13289bcff/' \\\n--header 'Authorization: CodeRequest {{api_key}}' \\\n--header 'Content-Type: application/json' \\\n--data-raw '{\n \"birthday\": \"02.01.1990\"\n}'\n```\n\n### Примечания\n- Переменные (`user_vars`) обновляются только если явно переданы в запросе.\n- Чтобы удалить значение пользовательской переменной, передайте `null` — работает для всех типов переменных.\n- Альтернативные способы обновления: эндпоинт `/api/v2/emails/update/` (передача `email` + `source` в теле) или массовое обновление `/api/v2/emails/mass/`.\n\n📄 Документация: https://documentation.mailganer.ru/documentation/email/update"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"invalid\",\n \"error\": {\n \"source\": [\"Not found site or blocked\"],\n \"birthday\": [\"Неправильный формат date. Используйте: DD.MM.YYYY\"]\n }\n}"}],"_postman_id":"6a6c495c-6736-4b2a-baa5-baeaaef79f1b"},{"name":"Обновление информации о подписчике 2 способ","id":"d1ce8219-d04f-41fa-a380-ac124173e6d5","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PATCH","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"email\": \"test@example.com\",\n \"source\": \"51488\",\n \"birthday\": \"05.01.1990\"\n}","options":{"raw":{"language":"json"}}},"url":"https://mailganer.com/api/v2/emails/update/","description":"

Обновляет информацию о подписчике, идентифицируя его по паре email + source в теле запроса.

Эндпоинт: PATCH https://mailganer.com/api/v2/emails/update/\nАвторизация: заголовок Authorization: CodeRequest {{api_key}} (наследуется от коллекции)\nContent-Type: application/json

Тело запроса

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Поле	Тип	Обяз.	Описание
`email`	string	да	Имейл подписчика
`source`	int / array / `\"all\"`	да	ID списка; можно передать несколько `[49767,50145]` или `\"all\"`
`phone`	string	нет	Телефон
`name`	string	нет	Имя
`surname`	string	нет	Фамилия
`patronymic`	string	нет	Отчество
`gender`	int	нет	1 — мужской, 2 — женский
`birthday`	string	нет	Дата рождения, формат `dd.mm.yyyy`
`city`	string	нет	Город
`add_tag`	string / array	нет	Добавить метку
`delete_tag`	string	нет	Удалить метку
`user_vars`	object	нет	Пользовательские переменные (передайте `null` в значении, чтобы удалить переменную)
`not_doi`	bool	нет	Отменить отправку письма подтверждения
`need_activate`	bool	нет	Отправить письмо подтверждения
`add_category`	string	нет	Добавить категорию подписки
`delete_category`	string	нет	Удалить категорию подписки

Пример curl

curl --location --request PATCH 'https://mailganer.com/api/v2/emails/update/' \\\n--header 'Authorization: CodeRequest {{api_key}}' \\\n--header 'Content-Type: application/json' \\\n--data-raw '{\n    \"email\": \"test@example.com\",\n    \"source\": \"51488\",\n    \"birthday\": \"05.01.1990\"\n}'\n

Примечания

Переменные (user_vars) обновляются только если явно переданы в запросе; значение null удаляет переменную (для всех типов).
Альтернативные способы: передача mg_hash в URL (/api/v2/emails/:email_hash/) или массовое обновление /api/v2/emails/mass/.

📄 Документация: https://documentation.mailganer.ru/documentation/email/update

\n","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":""}]},"isInherited":true,"source":{"_postman_id":"ad2a6101-55ec-46be-9158-ec0369852183","id":"ad2a6101-55ec-46be-9158-ec0369852183","name":"REST API Mailganer","type":"collection"}},"urlObject":{"protocol":"https","path":["api","v2","emails","update",""],"host":["mailganer","com"],"query":[],"variable":[]}},"response":[{"id":"1bf26958-597d-faab-3afc-5f86f4f6d24c","name":"Успех (200)","originalRequest":{"method":"PATCH","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"email\": \"test@example.com\",\n \"source\": \"51488\",\n \"birthday\": \"05.01.1990\"\n}","options":{"raw":{"language":"json"}}},"url":"https://mailganer.com/api/v2/emails/update/","description":"Обновляет информацию о подписчике, идентифицируя его по паре `email` + `source` в теле запроса.\n\n**Эндпоинт:** `PATCH https://mailganer.com/api/v2/emails/update/`\n**Авторизация:** заголовок `Authorization: CodeRequest {{api_key}}` (наследуется от коллекции)\n**Content-Type:** `application/json`\n\n### Тело запроса\n| Поле | Тип | Обяз. | Описание |\n|---|---|---|---|\n| `email` | string | да | Имейл подписчика |\n| `source` | int / array / `\"all\"` | да | ID списка; можно передать несколько `[49767,50145]` или `\"all\"` |\n| `phone` | string | нет | Телефон |\n| `name` | string | нет | Имя |\n| `surname` | string | нет | Фамилия |\n| `patronymic` | string | нет | Отчество |\n| `gender` | int | нет | 1 — мужской, 2 — женский |\n| `birthday` | string | нет | Дата рождения, формат `dd.mm.yyyy` |\n| `city` | string | нет | Город |\n| `add_tag` | string / array | нет | Добавить метку |\n| `delete_tag` | string | нет | Удалить метку |\n| `user_vars` | object | нет | Пользовательские переменные (передайте `null` в значении, чтобы удалить переменную) |\n| `not_doi` | bool | нет | Отменить отправку письма подтверждения |\n| `need_activate` | bool | нет | Отправить письмо подтверждения |\n| `add_category` | string | нет | Добавить категорию подписки |\n| `delete_category` | string | нет | Удалить категорию подписки |\n\n### Пример curl\n```bash\ncurl --location --request PATCH 'https://mailganer.com/api/v2/emails/update/' \\\n--header 'Authorization: CodeRequest {{api_key}}' \\\n--header 'Content-Type: application/json' \\\n--data-raw '{\n \"email\": \"test@example.com\",\n \"source\": \"51488\",\n \"birthday\": \"05.01.1990\"\n}'\n```\n\n### Примечания\n- Переменные (`user_vars`) обновляются только если явно переданы в запросе; значение `null` удаляет переменную (для всех типов).\n- Альтернативные способы: передача `mg_hash` в URL (`/api/v2/emails/:email_hash/`) или массовое обновление `/api/v2/emails/mass/`.\n\n📄 Документация: https://documentation.mailganer.ru/documentation/email/update"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"id\": 45763880,\n \"mg_hash\": \"53158545763880e054b31ecbad2cf3265d4001d1\"\n}"},{"id":"9173eabf-6242-c2fa-a6df-745b2031bba4","name":"Ошибка (400)","originalRequest":{"method":"PATCH","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"email\": \"test@example.com\",\n \"source\": \"51488\",\n \"birthday\": \"05.01.1990\"\n}","options":{"raw":{"language":"json"}}},"url":"https://mailganer.com/api/v2/emails/update/","description":"Обновляет информацию о подписчике, идентифицируя его по паре `email` + `source` в теле запроса.\n\n**Эндпоинт:** `PATCH https://mailganer.com/api/v2/emails/update/`\n**Авторизация:** заголовок `Authorization: CodeRequest {{api_key}}` (наследуется от коллекции)\n**Content-Type:** `application/json`\n\n### Тело запроса\n| Поле | Тип | Обяз. | Описание |\n|---|---|---|---|\n| `email` | string | да | Имейл подписчика |\n| `source` | int / array / `\"all\"` | да | ID списка; можно передать несколько `[49767,50145]` или `\"all\"` |\n| `phone` | string | нет | Телефон |\n| `name` | string | нет | Имя |\n| `surname` | string | нет | Фамилия |\n| `patronymic` | string | нет | Отчество |\n| `gender` | int | нет | 1 — мужской, 2 — женский |\n| `birthday` | string | нет | Дата рождения, формат `dd.mm.yyyy` |\n| `city` | string | нет | Город |\n| `add_tag` | string / array | нет | Добавить метку |\n| `delete_tag` | string | нет | Удалить метку |\n| `user_vars` | object | нет | Пользовательские переменные (передайте `null` в значении, чтобы удалить переменную) |\n| `not_doi` | bool | нет | Отменить отправку письма подтверждения |\n| `need_activate` | bool | нет | Отправить письмо подтверждения |\n| `add_category` | string | нет | Добавить категорию подписки |\n| `delete_category` | string | нет | Удалить категорию подписки |\n\n### Пример curl\n```bash\ncurl --location --request PATCH 'https://mailganer.com/api/v2/emails/update/' \\\n--header 'Authorization: CodeRequest {{api_key}}' \\\n--header 'Content-Type: application/json' \\\n--data-raw '{\n \"email\": \"test@example.com\",\n \"source\": \"51488\",\n \"birthday\": \"05.01.1990\"\n}'\n```\n\n### Примечания\n- Переменные (`user_vars`) обновляются только если явно переданы в запросе; значение `null` удаляет переменную (для всех типов).\n- Альтернативные способы: передача `mg_hash` в URL (`/api/v2/emails/:email_hash/`) или массовое обновление `/api/v2/emails/mass/`.\n\n📄 Документация: https://documentation.mailganer.ru/documentation/email/update"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"invalid\",\n \"error\": {\n \"source\": [\"Not found site or blocked\"],\n \"birthday\": [\"Неправильный формат date. Используйте: DD.MM.YYYY\"]\n }\n}"}],"_postman_id":"d1ce8219-d04f-41fa-a380-ac124173e6d5"},{"name":"Массовое добавление подписчиков","id":"4060bb4c-c135-422b-a043-56d7cb7988ee","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"[\n {\n \"email\": \"test1@example.com\",\n \"source\": 51488,\n \"name\": \"Федор\",\n \"patronymic\": \"Федорович\",\n \"surname\": \"Федоров\",\n \"gender\": 1,\n \"birthday\": \"01.01.1988\",\n \"user_vars\": {\n \"lastbuy\": \"01.01.1971\"\n }\n },\n {\n \"email\": \"test2@example.com\",\n \"source\": 51488,\n \"name\": \"Пётр\",\n \"patronymic\": \"Петрович\",\n \"surname\": \"Петров\",\n \"gender\": 1,\n \"birthday\": \"01.01.1988\",\n \"user_vars\": {\n \"lastbuy\": \"01.01.1971\"\n }\n }\n]","options":{"raw":{"language":"json"}}},"url":"https://mailganer.com/api/v2/emails/","description":"

Добавляет до 50 подписчиков за один запрос. Тело — JSON-массив объектов подписчиков.

Тело запроса

Массив объектов; поля каждого объекта:

Поле	Тип	Обяз.	Описание
`email`	string	да	Имейл подписчика
`source`	int / array / `\"all\"`	да	ID списка; можно передать несколько или `\"all\"` — во все списки
`phone`	string	нет	Телефон
`name`	string	нет	Имя
`surname`	string	нет	Фамилия
`patronymic`	string	нет	Отчество
`gender`	int	нет	1 — мужской, 2 — женский
`birthday`	string	нет	Дата рождения, формат `dd.mm.yyyy`
`city`	string	нет	Город
`add_tag`	string / array	нет	Добавить метку (≤ 140 символов)
`delete_tag`	string	нет	Удалить метку
`user_vars`	object	нет	Пользовательские переменные
`not_doi`	bool	нет	Отменить отправку письма подтверждения
`need_activate`	bool	нет	Отправить письмо подтверждения
`add_category`	string	нет	Добавить категорию подписки (≤ 250 символов)
`delete_category`	string	нет	Удалить категорию подписки

Пример curl

curl --location --request POST 'https://mailganer.com/api/v2/emails/' \\\n--header 'Authorization: CodeRequest {{api_key}}' \\\n--header 'Content-Type: application/json' \\\n--data-raw '[\n   {\"email\": \"test1@example.com\", \"source\": 51488, \"name\": \"Федор\"},\n   {\"email\": \"test2@example.com\", \"source\": 51488, \"name\": \"Пётр\"}\n]'\n

Примечания

Максимум 50 имейлов за запрос.
Атомарность: если хотя бы в одном имейле есть ошибка, ни один имейл из пакета не будет добавлен.
В ответе по каждому имейлу возвращаются id, mg_hash, in_base (был ли уже в базе) и email_status.
Повторная отправка DOI-письма возможна через 1 час.
При HTTP 503 необходимо повторить запрос с задержкой.

📄 Документация: https://documentation.mailganer.ru/documentation/email/add/mass

\n","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":""}]},"isInherited":true,"source":{"_postman_id":"ad2a6101-55ec-46be-9158-ec0369852183","id":"ad2a6101-55ec-46be-9158-ec0369852183","name":"REST API Mailganer","type":"collection"}},"urlObject":{"protocol":"https","path":["api","v2","emails",""],"host":["mailganer","com"],"query":[],"variable":[]}},"response":[{"id":"5ea3cac4-0e6d-4971-acae-83f35ba02a5d","name":"Успех (200)","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"[\n {\n \"email\": \"test1@example.com\",\n \"source\": 51488,\n \"name\": \"Федор\",\n \"patronymic\": \"Федорович\",\n \"surname\": \"Федоров\",\n \"gender\": 1,\n \"birthday\": \"01.01.1988\",\n \"user_vars\": {\n \"lastbuy\": \"01.01.1971\"\n }\n },\n {\n \"email\": \"test2@example.com\",\n \"source\": 51488,\n \"name\": \"Пётр\",\n \"patronymic\": \"Петрович\",\n \"surname\": \"Петров\",\n \"gender\": 1,\n \"birthday\": \"01.01.1988\",\n \"user_vars\": {\n \"lastbuy\": \"01.01.1971\"\n }\n }\n]","options":{"raw":{"language":"json"}}},"url":"https://mailganer.com/api/v2/emails/","description":"Добавляет до 50 подписчиков за один запрос. Тело — JSON-массив объектов подписчиков.\n\n**Эндпоинт:** `POST https://mailganer.com/api/v2/emails/`\n**Авторизация:** заголовок `Authorization: CodeRequest {{api_key}}` (наследуется от коллекции)\n**Content-Type:** `application/json`\n\n### Тело запроса\nМассив объектов; поля каждого объекта:\n| Поле | Тип | Обяз. | Описание |\n|---|---|---|---|\n| `email` | string | да | Имейл подписчика |\n| `source` | int / array / `\"all\"` | да | ID списка; можно передать несколько или `\"all\"` — во все списки |\n| `phone` | string | нет | Телефон |\n| `name` | string | нет | Имя |\n| `surname` | string | нет | Фамилия |\n| `patronymic` | string | нет | Отчество |\n| `gender` | int | нет | 1 — мужской, 2 — женский |\n| `birthday` | string | нет | Дата рождения, формат `dd.mm.yyyy` |\n| `city` | string | нет | Город |\n| `add_tag` | string / array | нет | Добавить метку (≤ 140 символов) |\n| `delete_tag` | string | нет | Удалить метку |\n| `user_vars` | object | нет | Пользовательские переменные |\n| `not_doi` | bool | нет | Отменить отправку письма подтверждения |\n| `need_activate` | bool | нет | Отправить письмо подтверждения |\n| `add_category` | string | нет | Добавить категорию подписки (≤ 250 символов) |\n| `delete_category` | string | нет | Удалить категорию подписки |\n\n### Пример curl\n```bash\ncurl --location --request POST 'https://mailganer.com/api/v2/emails/' \\\n--header 'Authorization: CodeRequest {{api_key}}' \\\n--header 'Content-Type: application/json' \\\n--data-raw '[\n {\"email\": \"test1@example.com\", \"source\": 51488, \"name\": \"Федор\"},\n {\"email\": \"test2@example.com\", \"source\": 51488, \"name\": \"Пётр\"}\n]'\n```\n\n### Примечания\n- Максимум **50** имейлов за запрос.\n- Атомарность: если хотя бы в одном имейле есть ошибка, **ни один** имейл из пакета не будет добавлен.\n- В ответе по каждому имейлу возвращаются `id`, `mg_hash`, `in_base` (был ли уже в базе) и `email_status`.\n- Повторная отправка DOI-письма возможна через 1 час.\n- При `HTTP 503` необходимо повторить запрос с задержкой.\n\n📄 Документация: https://documentation.mailganer.ru/documentation/email/add/mass"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"[\n {\n \"id\": 45764030,\n \"mg_hash\": \"100330457640309ee63894dced455d110aebcb2b\",\n \"in_base\": true,\n \"email_status\": \"active\"\n }\n]"},{"id":"87af54da-1236-1e43-4d80-4e4b7ffa2388","name":"Ошибка (400)","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"[\n {\n \"email\": \"test1@example.com\",\n \"source\": 51488,\n \"name\": \"Федор\",\n \"patronymic\": \"Федорович\",\n \"surname\": \"Федоров\",\n \"gender\": 1,\n \"birthday\": \"01.01.1988\",\n \"user_vars\": {\n \"lastbuy\": \"01.01.1971\"\n }\n },\n {\n \"email\": \"test2@example.com\",\n \"source\": 51488,\n \"name\": \"Пётр\",\n \"patronymic\": \"Петрович\",\n \"surname\": \"Петров\",\n \"gender\": 1,\n \"birthday\": \"01.01.1988\",\n \"user_vars\": {\n \"lastbuy\": \"01.01.1971\"\n }\n }\n]","options":{"raw":{"language":"json"}}},"url":"https://mailganer.com/api/v2/emails/","description":"Добавляет до 50 подписчиков за один запрос. Тело — JSON-массив объектов подписчиков.\n\n**Эндпоинт:** `POST https://mailganer.com/api/v2/emails/`\n**Авторизация:** заголовок `Authorization: CodeRequest {{api_key}}` (наследуется от коллекции)\n**Content-Type:** `application/json`\n\n### Тело запроса\nМассив объектов; поля каждого объекта:\n| Поле | Тип | Обяз. | Описание |\n|---|---|---|---|\n| `email` | string | да | Имейл подписчика |\n| `source` | int / array / `\"all\"` | да | ID списка; можно передать несколько или `\"all\"` — во все списки |\n| `phone` | string | нет | Телефон |\n| `name` | string | нет | Имя |\n| `surname` | string | нет | Фамилия |\n| `patronymic` | string | нет | Отчество |\n| `gender` | int | нет | 1 — мужской, 2 — женский |\n| `birthday` | string | нет | Дата рождения, формат `dd.mm.yyyy` |\n| `city` | string | нет | Город |\n| `add_tag` | string / array | нет | Добавить метку (≤ 140 символов) |\n| `delete_tag` | string | нет | Удалить метку |\n| `user_vars` | object | нет | Пользовательские переменные |\n| `not_doi` | bool | нет | Отменить отправку письма подтверждения |\n| `need_activate` | bool | нет | Отправить письмо подтверждения |\n| `add_category` | string | нет | Добавить категорию подписки (≤ 250 символов) |\n| `delete_category` | string | нет | Удалить категорию подписки |\n\n### Пример curl\n```bash\ncurl --location --request POST 'https://mailganer.com/api/v2/emails/' \\\n--header 'Authorization: CodeRequest {{api_key}}' \\\n--header 'Content-Type: application/json' \\\n--data-raw '[\n {\"email\": \"test1@example.com\", \"source\": 51488, \"name\": \"Федор\"},\n {\"email\": \"test2@example.com\", \"source\": 51488, \"name\": \"Пётр\"}\n]'\n```\n\n### Примечания\n- Максимум **50** имейлов за запрос.\n- Атомарность: если хотя бы в одном имейле есть ошибка, **ни один** имейл из пакета не будет добавлен.\n- В ответе по каждому имейлу возвращаются `id`, `mg_hash`, `in_base` (был ли уже в базе) и `email_status`.\n- Повторная отправка DOI-письма возможна через 1 час.\n- При `HTTP 503` необходимо повторить запрос с задержкой.\n\n📄 Документация: https://documentation.mailganer.ru/documentation/email/add/mass"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"value":"application/json","key":"Content-Type"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"invalid\",\n \"error\": [\n {},\n {\n \"source\": [\"Not found site (source_id=497672) or site blocked\"]\n }\n ]\n}"}],"_postman_id":"4060bb4c-c135-422b-a043-56d7cb7988ee"},{"name":"Получение информации о подписчике 1 способ","id":"74708a54-725e-4d5f-975f-f212241aa60b","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://mailganer.com/api/v2/emails/?email=test@example.com&source=51488","description":"

Возвращает информацию о подписчике(ах) с фильтрацией по query-параметрам.

Эндпоинт: GET https://mailganer.com/api/v2/emails/\nАвторизация: заголовок Authorization: CodeRequest {{api_key}} (наследуется от коллекции)

Query-параметры

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Поле	Тип	Обяз.	Описание
`email`	string	нет	Имейл, о котором нужна информация; оставьте пустым, чтобы получить по всем подписчикам
`source`	int	нет	ID списка; оставьте пустым, чтобы получить по всем спискам
`start_date`	string	нет	Фильтр по дате создания подписчика (формат `YYYY-MM-DD`)
`end_date`	string	нет	Фильтр по дате создания подписчика (формат `YYYY-MM-DD`)
`updated_at_start`	string	нет	Фильтр по дате изменения подписчика (формат `YYYY-MM-DD`)
`updated_at_end`	string	нет	Фильтр по дате изменения подписчика (формат `YYYY-MM-DD`)
`last_activity_days`	int	нет	Передайте `1`, чтобы дополнительно вернуть в ответе поле активности подписчика

Пример curl

curl --location --request GET 'https://mailganer.com/api/v2/emails/?email=test@example.com&source=51488' \\\n--header 'Authorization: CodeRequest {{api_key}}'\n

Примечания

При фильтрации по имейлу count всегда равен 1.
Если параметры дат не указаны — возвращаются все подписчики.
Активностью считается последнее открытие рассылки или триггерного письма.
Поле активности рассчитывается только если передан last_activity_days=1.
Ответ постраничный: поля next / previous / count / results.

📄 Документация: https://documentation.mailganer.ru/documentation/email/get

Имейл, о котором нужна информация; оставьте пустым, чтобы получить по всем подписчикам

\n","type":"text/plain"},"key":"email","value":"test@example.com"},{"description":{"content":"

ID списка; оставьте пустым, чтобы получить по всем спискам

\n","type":"text/plain"},"key":"source","value":"51488"},{"disabled":true,"description":{"content":"

Фильтр по дате создания подписчика (формат YYYY-MM-DD)

\n","type":"text/plain"},"key":"start_date","value":"2026-01-01"},{"disabled":true,"description":{"content":"

Фильтр по дате создания подписчика (формат YYYY-MM-DD)

\n","type":"text/plain"},"key":"end_date","value":"2026-12-31"},{"disabled":true,"description":{"content":"

Фильтр по дате изменения подписчика (формат YYYY-MM-DD)

\n","type":"text/plain"},"key":"updated_at_start","value":"2026-01-01"},{"disabled":true,"description":{"content":"

Фильтр по дате изменения подписчика (формат YYYY-MM-DD)

\n","type":"text/plain"},"key":"updated_at_end","value":"2026-12-31"},{"disabled":true,"description":{"content":"

Передайте 1, чтобы дополнительно вернуть в ответе поле активности подписчика

\n","type":"text/plain"},"key":"last_activity_days","value":"1"}],"variable":[]}},"response":[{"id":"16ea4c2c-fa4c-477d-b1b1-03f5ed9b56cc","name":"Email найден","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://mailganer.com/api/v2/emails/?email=test@example.com&source=51488","protocol":"https","host":["mailganer","com"],"path":["api","v2","emails",""],"query":[{"key":"email","value":"test@example.com","description":"Имейл, о котором вы хотите получить информацию"},{"key":"source","value":"51488","description":"ID списка, в котором находится имейл"}]}},"status":"OK (Email найден)","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx/1.16.1"},{"key":"Date","value":"Thu, 15 Dec 2022 07:33:33 GMT"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"close"},{"key":"Vary","value":"Accept, Accept-Language, Cookie, Origin"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"Content-Language","value":"ru"},{"key":"Allow","value":"GET, POST, HEAD, OPTIONS"}],"cookie":[],"responseTime":null,"body":"{\n \"count\": 1,\n \"next\": null,\n \"previous\": null,\n \"results\": [\n {\n \"id\": 115986334,\n \"mg_hash\": \"ae2f6611598633414be10fe73380863cb59afe7b8\",\n \"email\": \"vlad.tochonii@mailganer.ru\",\n \"source\": 57229,\n \"email_status\": \"active\",\n \"corrected_email\": null,\n \"name\": \"\",\n \"patronymic\": \"\",\n \"surname\": \"\",\n \"gender\": 0,\n \"birthday\": null,\n \"phone\": null,\n \"city\": \"\",\n \"country\": \"\",\n \"is_valid\": true,\n \"doi_is_delivery\": true,\n \"doi_is_open\": false,\n \"doi_is_click\": false,\n \"user_vars\": {\n \"nps\": \"ok\",\n \"test_date\": 1667520000\n },\n \"bunce_log\": null\n }\n ]\n}"},{"id":"289d0e7e-5085-4eac-9bf0-5a86e0c9e779","name":"Email не найден","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://mailganer.com/api/v2/emails/?email=test@example.com&source=51488","protocol":"https","host":["mailganer","com"],"path":["api","v2","emails",""],"query":[{"key":"email","value":"test@example.com","description":"Имейл, о котором вы хотите получить информацию"},{"key":"source","value":"51488","description":"ID списка, в котором находится имейл"}]}},"status":"OK (Email не найден)","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx/1.16.1"},{"key":"Date","value":"Thu, 15 Dec 2022 07:33:33 GMT"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"close"},{"key":"Vary","value":"Accept, Accept-Language, Cookie, Origin"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"Content-Language","value":"ru"},{"key":"Allow","value":"GET, POST, HEAD, OPTIONS"}],"cookie":[],"responseTime":null,"body":"{\n \"count\": 0,\n \"next\": null,\n \"previous\": null,\n \"results\": []\n}"},{"id":"20bc85e1-6ebb-1829-afc9-e98d19555084","name":"Ошибка (400) — неверный source","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://mailganer.com/api/v2/emails/?email=test@example.com&source=51488","protocol":"https","host":["mailganer","com"],"path":["api","v2","emails",""],"query":[{"key":"email","description":"Имейл, о котором нужна информация; оставьте пустым, чтобы получить по всем подписчикам","value":"test@example.com"},{"key":"source","description":"ID списка; оставьте пустым, чтобы получить по всем спискам","value":"51488"},{"key":"start_date","description":"Фильтр по дате создания подписчика (формат YYYY-MM-DD)","value":"2026-01-01","disabled":true},{"key":"end_date","description":"Фильтр по дате создания подписчика (формат YYYY-MM-DD)","value":"2026-12-31","disabled":true},{"key":"updated_at_start","description":"Фильтр по дате изменения подписчика (формат YYYY-MM-DD)","value":"2026-01-01","disabled":true},{"key":"updated_at_end","description":"Фильтр по дате изменения подписчика (формат YYYY-MM-DD)","value":"2026-12-31","disabled":true},{"key":"last_activity_days","description":"Передайте 1, чтобы дополнительно вернуть в ответе поле активности подписчика","value":"1","disabled":true}]},"description":"Возвращает информацию о подписчике(ах) с фильтрацией по query-параметрам.\n\n**Эндпоинт:** `GET https://mailganer.com/api/v2/emails/`\n**Авторизация:** заголовок `Authorization: CodeRequest {{api_key}}` (наследуется от коллекции)\n\n### Query-параметры\n| Поле | Тип | Обяз. | Описание |\n|---|---|---|---|\n| `email` | string | нет | Имейл, о котором нужна информация; оставьте пустым, чтобы получить по всем подписчикам |\n| `source` | int | нет | ID списка; оставьте пустым, чтобы получить по всем спискам |\n| `start_date` | string | нет | Фильтр по дате создания подписчика (формат `YYYY-MM-DD`) |\n| `end_date` | string | нет | Фильтр по дате создания подписчика (формат `YYYY-MM-DD`) |\n| `updated_at_start` | string | нет | Фильтр по дате изменения подписчика (формат `YYYY-MM-DD`) |\n| `updated_at_end` | string | нет | Фильтр по дате изменения подписчика (формат `YYYY-MM-DD`) |\n| `last_activity_days` | int | нет | Передайте `1`, чтобы дополнительно вернуть в ответе поле активности подписчика |\n\n### Пример curl\n```bash\ncurl --location --request GET 'https://mailganer.com/api/v2/emails/?email=test@example.com&source=51488' \\\n--header 'Authorization: CodeRequest {{api_key}}'\n```\n\n### Примечания\n- При фильтрации по имейлу `count` всегда равен `1`.\n- Если параметры дат не указаны — возвращаются все подписчики.\n- Активностью считается последнее открытие рассылки или триггерного письма.\n- Поле активности рассчитывается только если передан `last_activity_days=1`.\n- Ответ постраничный: поля `next` / `previous` / `count` / `results`.\n\n📄 Документация: https://documentation.mailganer.ru/documentation/email/get"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"invalid\",\n \"error\": {\n \"source\": [\"Not found site (source_id=497671) or site blocked\"]\n }\n}"},{"id":"213d6b80-2bbf-a8e2-628e-c715ed4953f9","name":"Ошибка (400) — неверная дата","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://mailganer.com/api/v2/emails/?email=test@example.com&source=51488","protocol":"https","host":["mailganer","com"],"path":["api","v2","emails",""],"query":[{"key":"email","description":"Имейл, о котором нужна информация; оставьте пустым, чтобы получить по всем подписчикам","value":"test@example.com"},{"key":"source","description":"ID списка; оставьте пустым, чтобы получить по всем спискам","value":"51488"},{"key":"start_date","description":"Фильтр по дате создания подписчика (формат YYYY-MM-DD)","value":"2026-01-01","disabled":true},{"key":"end_date","description":"Фильтр по дате создания подписчика (формат YYYY-MM-DD)","value":"2026-12-31","disabled":true},{"key":"updated_at_start","description":"Фильтр по дате изменения подписчика (формат YYYY-MM-DD)","value":"2026-01-01","disabled":true},{"key":"updated_at_end","description":"Фильтр по дате изменения подписчика (формат YYYY-MM-DD)","value":"2026-12-31","disabled":true},{"key":"last_activity_days","description":"Передайте 1, чтобы дополнительно вернуть в ответе поле активности подписчика","value":"1","disabled":true}]},"description":"Возвращает информацию о подписчике(ах) с фильтрацией по query-параметрам.\n\n**Эндпоинт:** `GET https://mailganer.com/api/v2/emails/`\n**Авторизация:** заголовок `Authorization: CodeRequest {{api_key}}` (наследуется от коллекции)\n\n### Query-параметры\n| Поле | Тип | Обяз. | Описание |\n|---|---|---|---|\n| `email` | string | нет | Имейл, о котором нужна информация; оставьте пустым, чтобы получить по всем подписчикам |\n| `source` | int | нет | ID списка; оставьте пустым, чтобы получить по всем спискам |\n| `start_date` | string | нет | Фильтр по дате создания подписчика (формат `YYYY-MM-DD`) |\n| `end_date` | string | нет | Фильтр по дате создания подписчика (формат `YYYY-MM-DD`) |\n| `updated_at_start` | string | нет | Фильтр по дате изменения подписчика (формат `YYYY-MM-DD`) |\n| `updated_at_end` | string | нет | Фильтр по дате изменения подписчика (формат `YYYY-MM-DD`) |\n| `last_activity_days` | int | нет | Передайте `1`, чтобы дополнительно вернуть в ответе поле активности подписчика |\n\n### Пример curl\n```bash\ncurl --location --request GET 'https://mailganer.com/api/v2/emails/?email=test@example.com&source=51488' \\\n--header 'Authorization: CodeRequest {{api_key}}'\n```\n\n### Примечания\n- При фильтрации по имейлу `count` всегда равен `1`.\n- Если параметры дат не указаны — возвращаются все подписчики.\n- Активностью считается последнее открытие рассылки или триггерного письма.\n- Поле активности рассчитывается только если передан `last_activity_days=1`.\n- Ответ постраничный: поля `next` / `previous` / `count` / `results`.\n\n📄 Документация: https://documentation.mailganer.ru/documentation/email/get"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"invalid\",\n \"error\": {\n \"end_date\": [\"Введите правильную дату.\"]\n }\n}"},{"id":"91334ac7-6a62-fe87-7c03-0016f6610952","name":"Ошибка (400) — start_date позже end_date","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://mailganer.com/api/v2/emails/?email=test@example.com&source=51488","protocol":"https","host":["mailganer","com"],"path":["api","v2","emails",""],"query":[{"key":"email","description":"Имейл, о котором нужна информация; оставьте пустым, чтобы получить по всем подписчикам","value":"test@example.com"},{"key":"source","description":"ID списка; оставьте пустым, чтобы получить по всем спискам","value":"51488"},{"key":"start_date","description":"Фильтр по дате создания подписчика (формат YYYY-MM-DD)","value":"2026-01-01","disabled":true},{"key":"end_date","description":"Фильтр по дате создания подписчика (формат YYYY-MM-DD)","value":"2026-12-31","disabled":true},{"key":"updated_at_start","description":"Фильтр по дате изменения подписчика (формат YYYY-MM-DD)","value":"2026-01-01","disabled":true},{"key":"updated_at_end","description":"Фильтр по дате изменения подписчика (формат YYYY-MM-DD)","value":"2026-12-31","disabled":true},{"key":"last_activity_days","description":"Передайте 1, чтобы дополнительно вернуть в ответе поле активности подписчика","value":"1","disabled":true}]},"description":"Возвращает информацию о подписчике(ах) с фильтрацией по query-параметрам.\n\n**Эндпоинт:** `GET https://mailganer.com/api/v2/emails/`\n**Авторизация:** заголовок `Authorization: CodeRequest {{api_key}}` (наследуется от коллекции)\n\n### Query-параметры\n| Поле | Тип | Обяз. | Описание |\n|---|---|---|---|\n| `email` | string | нет | Имейл, о котором нужна информация; оставьте пустым, чтобы получить по всем подписчикам |\n| `source` | int | нет | ID списка; оставьте пустым, чтобы получить по всем спискам |\n| `start_date` | string | нет | Фильтр по дате создания подписчика (формат `YYYY-MM-DD`) |\n| `end_date` | string | нет | Фильтр по дате создания подписчика (формат `YYYY-MM-DD`) |\n| `updated_at_start` | string | нет | Фильтр по дате изменения подписчика (формат `YYYY-MM-DD`) |\n| `updated_at_end` | string | нет | Фильтр по дате изменения подписчика (формат `YYYY-MM-DD`) |\n| `last_activity_days` | int | нет | Передайте `1`, чтобы дополнительно вернуть в ответе поле активности подписчика |\n\n### Пример curl\n```bash\ncurl --location --request GET 'https://mailganer.com/api/v2/emails/?email=test@example.com&source=51488' \\\n--header 'Authorization: CodeRequest {{api_key}}'\n```\n\n### Примечания\n- При фильтрации по имейлу `count` всегда равен `1`.\n- Если параметры дат не указаны — возвращаются все подписчики.\n- Активностью считается последнее открытие рассылки или триггерного письма.\n- Поле активности рассчитывается только если передан `last_activity_days=1`.\n- Ответ постраничный: поля `next` / `previous` / `count` / `results`.\n\n📄 Документация: https://documentation.mailganer.ru/documentation/email/get"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"invalid\",\n \"error\": {\n \"detail\": \"start_date cannot be later than end_date\"\n }\n}"}],"_postman_id":"74708a54-725e-4d5f-975f-f212241aa60b"},{"name":"Получение информации о подписчике 2 способ","id":"e917fcbe-1b73-41d9-a7bc-dd8e3e469abe","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://mailganer.com/api/v2/emails/:email_hash/","description":"

Возвращает информацию о конкретном подписчике по хэшу имейла (mg_hash) в URL.

Эндпоинт: GET https://mailganer.com/api/v2/emails/:email_hash/\nАвторизация: заголовок Authorization: CodeRequest {{api_key}} (наследуется от коллекции)

Подписчик определяется по path-переменной email_hash (значение mg_hash). Query-параметры не требуются.

Пример curl

curl --location --request GET 'https://mailganer.com/api/v2/emails/ae2f6611598633414be10fe73380863cb59afe7b8/' \\\n--header 'Authorization: CodeRequest {{api_key}}'\n

Примечания

Возвращается тот же формат объекта подписчика, что и в способе 1 (поля id, mg_hash, email, source, email_status, user_vars, tags, categories, created, modified и др.).
Если подписчик по хэшу не найден — вернётся ошибка «Не найдено.».

📄 Документация: https://documentation.mailganer.ru/documentation/email/get

Хэш имейла

\n","type":"text/plain"},"type":"any","value":"a05ad557332370764cd4f267a251f3b13289bcff","key":"email_hash"}]}},"response":[{"id":"a8d51db5-e514-aa21-bf27-7d2ee855d5ec","name":"Успех (200)","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://mailganer.com/api/v2/emails/:email_hash/","protocol":"https","host":["mailganer","com"],"path":["api","v2","emails",":email_hash",""],"variable":[{"key":"email_hash","value":"a05ad557332370764cd4f267a251f3b13289bcff","description":"Хэш имейла"}]},"description":"Возвращает информацию о конкретном подписчике по хэшу имейла (`mg_hash`) в URL.\n\n**Эндпоинт:** `GET https://mailganer.com/api/v2/emails/:email_hash/`\n**Авторизация:** заголовок `Authorization: CodeRequest {{api_key}}` (наследуется от коллекции)\n\nПодписчик определяется по path-переменной `email_hash` (значение `mg_hash`). Query-параметры не требуются.\n\n### Пример curl\n```bash\ncurl --location --request GET 'https://mailganer.com/api/v2/emails/ae2f6611598633414be10fe73380863cb59afe7b8/' \\\n--header 'Authorization: CodeRequest {{api_key}}'\n```\n\n### Примечания\n- Возвращается тот же формат объекта подписчика, что и в способе 1 (поля `id`, `mg_hash`, `email`, `source`, `email_status`, `user_vars`, `tags`, `categories`, `created`, `modified` и др.).\n- Если подписчик по хэшу не найден — вернётся ошибка «Не найдено.».\n\n📄 Документация: https://documentation.mailganer.ru/documentation/email/get"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"id\": 321456817,\n \"mg_hash\": \"54ede83211718173f544604ebe5ad1867543b348185\",\n \"email\": \"test@gmail.com\",\n \"source\": 104363,\n \"email_status\": \"active\",\n \"corrected_email\": null,\n \"name\": \"\",\n \"patronymic\": \"\",\n \"surname\": \"\",\n \"gender\": 0,\n \"birthday\": null,\n \"phone\": null,\n \"city\": null,\n \"country\": null,\n \"is_valid\": false,\n \"doi_is_delivery\": false,\n \"doi_is_open\": false,\n \"doi_is_click\": false,\n \"user_vars\": {\"date_glob\": null, \"glob\": 66432},\n \"bunce_log\": null,\n \"tags\": [],\n \"categories\": [],\n \"created\": \"2026-03-03T16:06:29.724362\",\n \"modified\": \"2026-03-03T16:06:29.740263\"\n}"}],"_postman_id":"e917fcbe-1b73-41d9-a7bc-dd8e3e469abe"},{"name":"Отписка подписчика 1 способ","id":"ef19accb-8086-4818-b203-b03fdf40fddd","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"url":"https://mailganer.com/api/v2/emails/:email_hash/unsubscribe/","description":"

Отписывает подписчика, идентифицируя его по хэшу имейла (mg_hash) в URL. Это рабочий способ отписки.

Эндпоинт: POST https://mailganer.com/api/v2/emails/:email_hash/unsubscribe/\nАвторизация: заголовок Authorization: CodeRequest {{api_key}} (наследуется от коллекции)

Подписчик определяется по path-переменной email_hash (значение mg_hash). Тело запроса не требуется.

Пример curl

curl --location --request POST 'https://mailganer.com/api/v2/emails/a05ad557332370764cd4f267a251f3b13289bcff/unsubscribe/' \\\n--header 'Authorization: CodeRequest {{api_key}}'\n

Примечания

Успешный ответ: {\"email_status\": \"unsubscribe\"} — статус подписки меняется на «Отписался».
Если подписчик по хэшу не найден — вернётся ошибка {\"status\": \"error\", \"error\": \"Не найдено.\"}.
На странице документации в таблице параметров ошибочно продублированы поля со страницы «получение информации о подписчике» (артефакт копирования). Рабочий вариант отписки — передача mg_hash в URL.

📄 Документация: https://documentation.mailganer.ru/documentation/email/unsubscribe

Хэш имейла

\n","type":"text/plain"},"type":"any","value":"a05ad557332370764cd4f267a251f3b13289bcff","key":"email_hash"}]}},"response":[{"id":"40592157-a099-226f-f732-4ef55c215d04","name":"Успех (200)","originalRequest":{"method":"POST","header":[],"url":{"raw":"https://mailganer.com/api/v2/emails/:email_hash/unsubscribe/","protocol":"https","host":["mailganer","com"],"path":["api","v2","emails",":email_hash","unsubscribe",""],"variable":[{"key":"email_hash","value":"a05ad557332370764cd4f267a251f3b13289bcff","description":"Хэш имейла"}]},"description":"Отписывает подписчика, идентифицируя его по хэшу имейла (`mg_hash`) в URL. Это рабочий способ отписки.\n\n**Эндпоинт:** `POST https://mailganer.com/api/v2/emails/:email_hash/unsubscribe/`\n**Авторизация:** заголовок `Authorization: CodeRequest {{api_key}}` (наследуется от коллекции)\n\nПодписчик определяется по path-переменной `email_hash` (значение `mg_hash`). Тело запроса не требуется.\n\n### Пример curl\n```bash\ncurl --location --request POST 'https://mailganer.com/api/v2/emails/a05ad557332370764cd4f267a251f3b13289bcff/unsubscribe/' \\\n--header 'Authorization: CodeRequest {{api_key}}'\n```\n\n### Примечания\n- Успешный ответ: `{\"email_status\": \"unsubscribe\"}` — статус подписки меняется на «Отписался».\n- Если подписчик по хэшу не найден — вернётся ошибка `{\"status\": \"error\", \"error\": \"Не найдено.\"}`.\n- На странице документации в таблице параметров ошибочно продублированы поля со страницы «получение информации о подписчике» (артефакт копирования). Рабочий вариант отписки — передача `mg_hash` в URL.\n\n📄 Документация: https://documentation.mailganer.ru/documentation/email/unsubscribe"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"email_status\": \"unsubscribe\"\n}"},{"id":"291d4173-2f5a-e3b4-a621-74c9339132dc","name":"Ошибка (404)","originalRequest":{"method":"POST","header":[],"url":{"raw":"https://mailganer.com/api/v2/emails/:email_hash/unsubscribe/","protocol":"https","host":["mailganer","com"],"path":["api","v2","emails",":email_hash","unsubscribe",""],"variable":[{"key":"email_hash","value":"a05ad557332370764cd4f267a251f3b13289bcff","description":"Хэш имейла"}]},"description":"Отписывает подписчика, идентифицируя его по хэшу имейла (`mg_hash`) в URL. Это рабочий способ отписки.\n\n**Эндпоинт:** `POST https://mailganer.com/api/v2/emails/:email_hash/unsubscribe/`\n**Авторизация:** заголовок `Authorization: CodeRequest {{api_key}}` (наследуется от коллекции)\n\nПодписчик определяется по path-переменной `email_hash` (значение `mg_hash`). Тело запроса не требуется.\n\n### Пример curl\n```bash\ncurl --location --request POST 'https://mailganer.com/api/v2/emails/a05ad557332370764cd4f267a251f3b13289bcff/unsubscribe/' \\\n--header 'Authorization: CodeRequest {{api_key}}'\n```\n\n### Примечания\n- Успешный ответ: `{\"email_status\": \"unsubscribe\"}` — статус подписки меняется на «Отписался».\n- Если подписчик по хэшу не найден — вернётся ошибка `{\"status\": \"error\", \"error\": \"Не найдено.\"}`.\n- На странице документации в таблице параметров ошибочно продублированы поля со страницы «получение информации о подписчике» (артефакт копирования). Рабочий вариант отписки — передача `mg_hash` в URL.\n\n📄 Документация: https://documentation.mailganer.ru/documentation/email/unsubscribe"},"status":"Not Found","code":404,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"error\",\n \"error\": \"Не найдено.\"\n}"}],"_postman_id":"ef19accb-8086-4818-b203-b03fdf40fddd"},{"name":"Отписка подписчика 2 способ","id":"d8039ae0-9b88-4484-a898-7a72a771e93e","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"value":"application/json","key":"Content-Type"}],"body":{"mode":"raw","raw":"{\n \"email\": \"test@example.com\",\n \"source\": \"51488\"\n}","options":{"raw":{"language":"json"}}},"url":"https://mailganer.com/api/v2/emails/unsubscribe/","description":"

Отписывает подписчика, идентифицируя его по паре email + source в теле запроса.

Эндпоинт: POST https://mailganer.com/api/v2/emails/unsubscribe/\nАвторизация: заголовок Authorization: CodeRequest {{api_key}} (наследуется от коллекции)\nContent-Type: application/json

Тело запроса

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Поле	Тип	Обяз.	Описание
`email`	string	да	Имейл подписчика
`source`	int / array / `\"all\"`	да	ID списка; можно передать несколько или `\"all\"`

Пример curl

curl --location --request POST 'https://mailganer.com/api/v2/emails/unsubscribe/' \\\n--header 'Authorization: CodeRequest {{api_key}}' \\\n--header 'Content-Type: application/json' \\\n--data-raw '{\n    \"email\": \"test@example.com\",\n    \"source\": \"51488\"\n}'\n

Примечания

Успешный ответ: {\"email_status\": \"unsubscribe\"} — статус подписки меняется на «Отписался».
Если подписчик не найден — вернётся ошибка {\"status\": \"error\", \"error\": \"Не найдено.\"}.
В таблице параметров на странице документации ошибочно продублированы поля фильтрации со страницы «получение информации о подписчике» (start_date, end_date, updated_at_start, updated_at_end, last_activity_days) — это артефакт копирования; для отписки используются email + source. Полностью рабочий вариант — передача mg_hash в URL (способ 1).

📄 Документация: https://documentation.mailganer.ru/documentation/email/unsubscribe

Проверяет валидность имейла. Валидация тарифицируется отдельно.

Эндпоинт: POST https://mailganer.com/api/v2/emails/validate/\nАвторизация: заголовок Authorization: CodeRequest {{api_key}}\nContent-Type: application/json

Тело запроса

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Поле	Тип	Обяз.	Описание
`email`	string	✔	Имейл
`source`	int	✔	ID списка

Пример curl

curl --location --request POST 'https://mailganer.com/api/v2/emails/validate/' \\\n--header 'Authorization: CodeRequest {{api_key}}' \\\n--header 'Content-Type: application/json' \\\n--data-raw '{\n    \"email\": \"test@example.com\",\n    \"source\": 49767\n}'\n

Примечания

При слишком частых запросах по одному имейлу — ошибка «Email to many add method».
В ответе is_valid показывает результат проверки; corrected_email — исправленный имейл (если было исправление).

📄 Документация: https://documentation.mailganer.ru/documentation/email/validate

Обновляет до 50 подписчиков за один запрос. Тело — JSON-массив объектов. Операция атомарна.

Эндпоинт: PATCH https://mailganer.com/api/v2/emails/mass/\nАвторизация: заголовок Authorization: CodeRequest {{api_key}} (наследуется от коллекции)\nContent-Type: application/json

Тело запроса

Массив объектов; поля каждого объекта:

Поле	Тип	Обяз.	Описание
`email`	string	да	Имейл подписчика
`source`	int / array / `\"all\"`	да	ID списка (узнать ID: https://mailganer.com/app/settings/); можно передать несколько или `\"all\"`
`phone`	string	нет	Телефон
`name`	string	нет	Имя
`surname`	string	нет	Фамилия
`patronymic`	string	нет	Отчество
`gender`	int	нет	1 — мужской, 2 — женский
`birthday`	string	нет	Дата рождения, формат `dd.mm.yyyy`
`city`	string	нет	Город
`add_tag`	string / array	нет	Добавить метку
`delete_tag`	string	нет	Удалить метку
`user_vars`	object	нет	Пользовательские переменные; чтобы удалить значение переменной — передайте `null`
`not_doi`	bool	нет	Отменяет отправку письма подтверждения; имейл добавляется в статусе «Активен»
`need_activate`	bool	нет	Отправляет письмо подтверждения, даже если имейл в статусе «Запрошено подтверждение»
`add_category`	string	нет	Добавить категорию подписки
`delete_category`	string	нет	Удалить категорию подписки
`email_status`	string	нет	Изменить статус. Значение `unsubscribe` меняет статус подписчика с «Активен» на «Отписался»

Пример curl

curl --location --request PATCH 'https://mailganer.com/api/v2/emails/mass/' \\\n--header 'Authorization: CodeRequest {{api_key}}' \\\n--header 'Content-Type: application/json' \\\n--data-raw '[\n    {\n        \"email\": \"test@example.com\",\n        \"source\": 49767,\n        \"name\": \"Федор\",\n        \"surname\": \"Федоров\"\n    }\n]'\n

Примечания

Максимум 50 имейлов за запрос.
Атомарность: если хотя бы в одном имейле есть ошибка, ни один имейл из пакета не будет обновлён.
source принимает: одиночный ID, массив ID или \"all\" (все списки).
В ответе по каждому имейлу возвращаются id и mg_hash.

📄 Документация: https://documentation.mailganer.ru/documentation/email/update/mass

\n","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":""}]},"isInherited":true,"source":{"_postman_id":"ad2a6101-55ec-46be-9158-ec0369852183","id":"ad2a6101-55ec-46be-9158-ec0369852183","name":"REST API Mailganer","type":"collection"}},"urlObject":{"protocol":"https","path":["api","v2","emails","mass",""],"host":["mailganer","com"],"query":[],"variable":[]}},"response":[{"id":"799cdd23-1878-adad-1f3e-14d7f49ecc0c","name":"Успех (200)","originalRequest":{"method":"PATCH","header":[{"value":"application/json","key":"Content-Type"}],"body":{"mode":"raw","raw":"[\n {\n \"email\": \"test@example.com\",\n \"source\": 49767,\n \"name\": \"Федор\",\n \"surname\": \"Федоров\"\n }\n]","options":{"raw":{"language":"json"}}},"url":"https://mailganer.com/api/v2/emails/mass/","description":"Обновляет до 50 подписчиков за один запрос. Тело — JSON-массив объектов. Операция атомарна.\n\n**Эндпоинт:** `PATCH https://mailganer.com/api/v2/emails/mass/`\n**Авторизация:** заголовок `Authorization: CodeRequest {{api_key}}` (наследуется от коллекции)\n**Content-Type:** `application/json`\n\n### Тело запроса\nМассив объектов; поля каждого объекта:\n| Поле | Тип | Обяз. | Описание |\n|---|---|---|---|\n| `email` | string | да | Имейл подписчика |\n| `source` | int / array / `\"all\"` | да | ID списка (узнать ID: https://mailganer.com/app/settings/); можно передать несколько или `\"all\"` |\n| `phone` | string | нет | Телефон |\n| `name` | string | нет | Имя |\n| `surname` | string | нет | Фамилия |\n| `patronymic` | string | нет | Отчество |\n| `gender` | int | нет | 1 — мужской, 2 — женский |\n| `birthday` | string | нет | Дата рождения, формат `dd.mm.yyyy` |\n| `city` | string | нет | Город |\n| `add_tag` | string / array | нет | Добавить метку |\n| `delete_tag` | string | нет | Удалить метку |\n| `user_vars` | object | нет | Пользовательские переменные; чтобы удалить значение переменной — передайте `null` |\n| `not_doi` | bool | нет | Отменяет отправку письма подтверждения; имейл добавляется в статусе «Активен» |\n| `need_activate` | bool | нет | Отправляет письмо подтверждения, даже если имейл в статусе «Запрошено подтверждение» |\n| `add_category` | string | нет | Добавить категорию подписки |\n| `delete_category` | string | нет | Удалить категорию подписки |\n| `email_status` | string | нет | Изменить статус. Значение `unsubscribe` меняет статус подписчика с «Активен» на «Отписался» |\n\n### Пример curl\n```bash\ncurl --location --request PATCH 'https://mailganer.com/api/v2/emails/mass/' \\\n--header 'Authorization: CodeRequest {{api_key}}' \\\n--header 'Content-Type: application/json' \\\n--data-raw '[\n {\n \"email\": \"test@example.com\",\n \"source\": 49767,\n \"name\": \"Федор\",\n \"surname\": \"Федоров\"\n }\n]'\n```\n\n### Примечания\n- Максимум **50** имейлов за запрос.\n- Атомарность: если хотя бы в одном имейле есть ошибка, **ни один** имейл из пакета не будет обновлён.\n- `source` принимает: одиночный ID, массив ID или `\"all\"` (все списки).\n- В ответе по каждому имейлу возвращаются `id` и `mg_hash`.\n\n📄 Документация: https://documentation.mailganer.ru/documentation/email/update/mass"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"[\n {\n \"id\": 45764030,\n \"mg_hash\": \"100330457640309ee63894dced455d110aebcb2b\"\n },\n {\n \"id\": 45764025,\n \"mg_hash\": \"e031e245764025457cb340b96fd670419cf95bb2\"\n }\n]"},{"id":"41e5d241-c042-8718-957d-476c7bfe5b99","name":"Ошибка (400)","originalRequest":{"method":"PATCH","header":[{"value":"application/json","key":"Content-Type"}],"body":{"mode":"raw","raw":"[\n {\n \"email\": \"test@example.com\",\n \"source\": 49767,\n \"name\": \"Федор\",\n \"surname\": \"Федоров\"\n }\n]","options":{"raw":{"language":"json"}}},"url":"https://mailganer.com/api/v2/emails/mass/","description":"Обновляет до 50 подписчиков за один запрос. Тело — JSON-массив объектов. Операция атомарна.\n\n**Эндпоинт:** `PATCH https://mailganer.com/api/v2/emails/mass/`\n**Авторизация:** заголовок `Authorization: CodeRequest {{api_key}}` (наследуется от коллекции)\n**Content-Type:** `application/json`\n\n### Тело запроса\nМассив объектов; поля каждого объекта:\n| Поле | Тип | Обяз. | Описание |\n|---|---|---|---|\n| `email` | string | да | Имейл подписчика |\n| `source` | int / array / `\"all\"` | да | ID списка (узнать ID: https://mailganer.com/app/settings/); можно передать несколько или `\"all\"` |\n| `phone` | string | нет | Телефон |\n| `name` | string | нет | Имя |\n| `surname` | string | нет | Фамилия |\n| `patronymic` | string | нет | Отчество |\n| `gender` | int | нет | 1 — мужской, 2 — женский |\n| `birthday` | string | нет | Дата рождения, формат `dd.mm.yyyy` |\n| `city` | string | нет | Город |\n| `add_tag` | string / array | нет | Добавить метку |\n| `delete_tag` | string | нет | Удалить метку |\n| `user_vars` | object | нет | Пользовательские переменные; чтобы удалить значение переменной — передайте `null` |\n| `not_doi` | bool | нет | Отменяет отправку письма подтверждения; имейл добавляется в статусе «Активен» |\n| `need_activate` | bool | нет | Отправляет письмо подтверждения, даже если имейл в статусе «Запрошено подтверждение» |\n| `add_category` | string | нет | Добавить категорию подписки |\n| `delete_category` | string | нет | Удалить категорию подписки |\n| `email_status` | string | нет | Изменить статус. Значение `unsubscribe` меняет статус подписчика с «Активен» на «Отписался» |\n\n### Пример curl\n```bash\ncurl --location --request PATCH 'https://mailganer.com/api/v2/emails/mass/' \\\n--header 'Authorization: CodeRequest {{api_key}}' \\\n--header 'Content-Type: application/json' \\\n--data-raw '[\n {\n \"email\": \"test@example.com\",\n \"source\": 49767,\n \"name\": \"Федор\",\n \"surname\": \"Федоров\"\n }\n]'\n```\n\n### Примечания\n- Максимум **50** имейлов за запрос.\n- Атомарность: если хотя бы в одном имейле есть ошибка, **ни один** имейл из пакета не будет обновлён.\n- `source` принимает: одиночный ID, массив ID или `\"all\"` (все списки).\n- В ответе по каждому имейлу возвращаются `id` и `mg_hash`.\n\n📄 Документация: https://documentation.mailganer.ru/documentation/email/update/mass"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"invalid\",\n \"error\": [\n {},\n {\n \"source\": [\"Not found site (source_id=497672) or site blocked\"]\n }\n ]\n}"}],"_postman_id":"14e2f946-b5f3-4682-bb90-ddd22fb763c8"}],"id":"95e94ec2-5951-40ae-99b8-08f52943c379","description":"

Группа методов для работы с сущностью \"Подписчик\"

\n","_postman_id":"95e94ec2-5951-40ae-99b8-08f52943c379","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":""}]},"isInherited":true,"source":{"_postman_id":"ad2a6101-55ec-46be-9158-ec0369852183","id":"ad2a6101-55ec-46be-9158-ec0369852183","name":"REST API Mailganer","type":"collection"}}},{"name":"Списки","item":[{"name":"Создать список","id":"e412cc2a-5bdc-4bab-ae0b-e62c2aa6caf4","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"domain\": \"test2\"\n}","options":{"raw":{"language":"json"}}},"url":"https://mailganer.com/api/v2/sites/","description":"

Создаёт новый список рассылки.

Эндпоинт: POST https://mailganer.com/api/v2/sites/
Авторизация: заголовок Authorization: CodeRequest {{api_key}} (наследуется от коллекции)
Content-Type: application/json

Тело запроса

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Поле	Тип	Обяз.	Описание
`domain`	string	да	Название списка

Пример curl

curl --location --request POST 'https://mailganer.com/api/v2/sites/' \\\n--header 'Authorization: CodeRequest {{api_key}}' \\\n--header 'Content-Type: application/json' \\\n--data-raw '{\n    \"domain\": \"test2\"\n}'\n\n

Примечания

В ответе возвращается объект созданного списка, включая его id.
\n
Поле domain не должно содержать недопустимые символы (например <, >).
\n
Комбинация полей domain и user должна быть уникальной (иначе non_field_errors).
\n

📄 Документация: https://documentation.mailganer.ru/documentation/sites/post

Возвращает постраничный массив списков рассылки аккаунта.

Эндпоинт: GET https://mailganer.com/api/v2/sites/\nАвторизация: заголовок Authorization: CodeRequest {{api_key}} (наследуется от коллекции)

Query-параметры

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Поле	Тип	Обяз.	Описание
`simple`	bool	нет	Если `true`, возвращаются только основные поля (`id` и `domain`). По умолчанию `false`

Пример curl

curl --location --request GET 'https://mailganer.com/api/v2/sites/' \\\n--header 'Authorization: CodeRequest {{api_key}}'\n

Примечания

Ответ постраничный: поля count, next, previous, results.
Стандартный элемент results содержит: id, domain, domain_ext, logo, user, click_domain, count_emails, count_emails_active.
При simple=true элемент results содержит только id и domain.

📄 Документация: https://documentation.mailganer.ru/documentation/sites/get

Если true — вернуть только id и domain (по умолчанию false)

\n","type":"text/plain"},"key":"simple","value":"true"}],"variable":[]}},"response":[{"id":"275663ef-3b31-4bf8-a738-31db57140dc0","name":"Success","originalRequest":{"method":"GET","header":[],"url":"https://mailganer.com/api/v2/sites/"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx/1.16.1"},{"key":"Date","value":"Fri, 09 Dec 2022 10:30:55 GMT"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"close"},{"key":"Vary","value":"Accept, Accept-Language, Cookie, Origin"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"Content-Language","value":"ru"},{"key":"Allow","value":"GET, POST, HEAD, OPTIONS"}],"cookie":[],"responseTime":null,"body":"{\n \"count\": 1,\n \"next\": null,\n \"previous\": null,\n \"results\": [\n {\n \"id\": 60968,\n \"domain\": \"mailagner.com\",\n \"domain_ext\": \"\",\n \"url\": \"\",\n \"logo\": null,\n \"user\": 10912,\n \"source_type\": 3,\n \"source\": 1,\n \"active\": true,\n \"click_domain\": \"click.mailagner.com\"\n }\n ]\n}"},{"id":"27d7cbb8-ef04-8884-e86d-b1f55231c060","name":"Успех (200, simple=true)","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://mailganer.com/api/v2/sites/","protocol":"https","host":["mailganer","com"],"path":["api","v2","sites",""],"query":[{"key":"simple","value":"true","description":"Если true — вернуть только id и domain (по умолчанию false)","disabled":true}]},"description":"Возвращает постраничный массив списков рассылки аккаунта.\n\n**Эндпоинт:** `GET https://mailganer.com/api/v2/sites/`\n**Авторизация:** заголовок `Authorization: CodeRequest {{api_key}}` (наследуется от коллекции)\n\n### Query-параметры\n| Поле | Тип | Обяз. | Описание |\n|---|---|---|---|\n| `simple` | bool | нет | Если `true`, возвращаются только основные поля (`id` и `domain`). По умолчанию `false` |\n\n### Пример curl\n```bash\ncurl --location --request GET 'https://mailganer.com/api/v2/sites/' \\\n--header 'Authorization: CodeRequest {{api_key}}'\n```\n\n### Примечания\n- Ответ постраничный: поля `count`, `next`, `previous`, `results`.\n- Стандартный элемент `results` содержит: `id`, `domain`, `domain_ext`, `logo`, `user`, `click_domain`, `count_emails`, `count_emails_active`.\n- При `simple=true` элемент `results` содержит только `id` и `domain`.\n\n📄 Документация: https://documentation.mailganer.ru/documentation/sites/get"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"value":"application/json","key":"Content-Type"}],"cookie":[],"responseTime":null,"body":"{\n \"count\": 2,\n \"next\": \"https://mailganer.com/api/v2/sites/?page=2&simple=true\",\n \"previous\": null,\n \"results\": [\n {\"id\": 56555, \"domain\": \"name\"},\n {\"id\": 453433, \"domain\": \"4654654\"}\n ]\n}"}],"_postman_id":"22942156-686e-4258-a780-dbcc3299cde7"},{"name":"Проверка верификации домена","id":"2b09930b-7969-4c07-9c7f-113e953d476e","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"body":{"mode":"urlencoded","urlencoded":[{"key":"domain","value":"mailganer.com","description":"

Домен, который необходимо проверить

\n","type":"text"}]},"url":"https://mailganer.com/api/v2/sites/verify_domain/","description":"

Проверяет статус верификации домена списка (SPF, DMARC, DKIM).

Эндпоинт: GET https://mailganer.com/api/v2/sites/verify_domain/\nАвторизация: заголовок Authorization: CodeRequest {{api_key}} (наследуется от коллекции)

Query-параметры

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Поле	Тип	Обяз.	Описание
`domain`	string	да	Домен, который необходимо проверить

Пример curl

curl --location --request GET 'https://mailganer.com/api/v2/sites/verify_domain/?domain=mailganer.com' \\\n--header 'Authorization: CodeRequest {{api_key}}'\n

Примечания

Ответ содержит булевы поля: verification_status (общий статус верификации), spf_status, dmarc_status, dkim_status.

📄 Документация: https://documentation.mailganer.ru/documentation/sites/verify_domain

Домен, который необходимо проверить

\n","type":"text/plain"},"key":"domain","value":"mailganer.com"}],"variable":[]}},"response":[{"id":"23f3e08a-a05b-49b6-becb-3f35199ad258","name":"Success","originalRequest":{"method":"GET","header":[],"body":{"mode":"urlencoded","urlencoded":[{"key":"domain","value":"mailganer.com","type":"text"}]},"url":"https://mailganer.com/api/v2/sites/verify_domain/"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx/1.16.1"},{"key":"Date","value":"Mon, 23 Jan 2023 07:46:39 GMT"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"close"},{"key":"Vary","value":"Accept, Accept-Language, Cookie, Origin"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"Content-Language","value":"ru"},{"key":"Allow","value":"GET, HEAD, OPTIONS"}],"cookie":[],"responseTime":null,"body":"{\n \"verification_status\": true,\n \"spf_status\": true,\n \"dmarc_status\": true,\n \"dkim_status\": true\n}"}],"_postman_id":"2b09930b-7969-4c07-9c7f-113e953d476e"},{"name":"Задать ссылку на webhook","id":"4597f5c7-c4e0-4c53-aedb-bead8670dbb0","request":{"method":"POST","header":[{"value":"application/json","key":"Content-Type"}],"body":{"mode":"raw","raw":"{\n \"id\": 1008,\n \"url\": \"https://webhook.site/example\",\n \"is_active\": true,\n \"is_use_auth_key\": true,\n \"is_enable_retry\": false\n}","options":{"raw":{"language":"json"}}},"url":"https://mailganer.com/api/v2/sites/set_webhook","description":"

Задаёт (или обновляет) URL webhook для списка и параметры его работы.

Эндпоинт: POST https://mailganer.com/api/v2/sites/set_webhook\nАвторизация: заголовок Authorization: CodeRequest {{api_key}} (наследуется от коллекции)\nContent-Type: application/json

Тело запроса

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Поле	Тип	Обяз.	Описание
`id`	string	да	ID списка (можно узнать в настройках списка: https://mailganer.com/app/settings/)
`url`	string	да	URL, на который отправляются события (webhook)
`is_active`	bool	нет	Включает/отключает отправку событий на webhook
`is_use_auth_key`	bool	нет	Включает/отключает отправку ключа авторизации в заголовке `Authorization`
`is_enable_retry`	bool	нет	Включает/отключает повторы, если URL хука недоступен

Пример curl

curl --location --request POST 'https://mailganer.com/api/v2/sites/set_webhook' \\\n--header 'Authorization: CodeRequest {{api_key}}' \\\n--header 'Content-Type: application/json' \\\n--data-raw '{\n    \"id\": 1008,\n    \"url\": \"https://webhook.site/example\",\n    \"is_active\": true,\n    \"is_use_auth_key\": true,\n    \"is_enable_retry\": false\n}'\n

Примечания

Повторы (is_enable_retry) выполняются тремя попытками при ошибке эндпоинта: через 5 секунд, 1 час и 24 часа.
Активировать webhook также можно в настройках списка на вкладке «Интеграции».
При is_use_auth_key=true ключ авторизации передаётся в заголовке Authorization.

📄 Документация: https://documentation.mailganer.ru/documentation/sites/set_webhook_url

Создаёт сегмент подписчиков по заданным условиям.

Эндпоинт: POST https://mailganer.com/api/v2/segments/\nАвторизация: заголовок Authorization: CodeRequest {{api_key}} (наследуется от коллекции)\nContent-Type: application/json

Тело запроса

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Поле	Тип	Обяз.	Описание
`title`	string	да	Название сегмента
`conditions`	array	да	Массив условий сегментации
`conditions[].condition`	int	да	Тип условия (например, `6` — «Метка», `5` — «Список»)
`conditions[].type_value`	int	да	Тип значения (`4` — «Равна одной из», `5` — «Не равна одной из»)
`conditions[].value`	array	да	Значения условия

Пример curl

curl --location --request POST 'https://mailganer.com/api/v2/segments/' \\\n--header 'Authorization: CodeRequest {{api_key}}' \\\n--header 'Content-Type: application/json' \\\n--data-raw '{\n    \"title\": \"Тест API\",\n    \"conditions\": [\n        {\n            \"condition\": 6,\n            \"type_value\": 4,\n            \"value\": [\"Тег\"]\n        },\n        {\n            \"condition\": 5,\n            \"type_value\": 4,\n            \"value\": [\"51822\"]\n        }\n    ]\n}'\n

Примечания

В ответе возвращаются status, segment_url (ссылка на созданный сегмент) и segment_id.

📄 Документация: https://documentation.mailganer.ru/documentation/segments/sozdanie-segmenta

Возвращает постраничный массив сегментов аккаунта.

Эндпоинт: GET https://mailganer.com/api/v2/segments/\nАвторизация: заголовок Authorization: CodeRequest {{api_key}} (наследуется от коллекции)

Пример curl

curl --location --request GET 'https://mailganer.com/api/v2/segments/' \\\n--header 'Authorization: CodeRequest {{api_key}}'\n

Примечания

Ответ постраничный: поля count, next, previous, results; переход по страницам — через next/previous (параметр page).
Элемент results содержит: title, id, cnt_email, cnt_active_email, created.
Метод не описан в публичной документации.

📄 Документация (раздел API): https://documentation.mailganer.ru/documentation/api

Возвращает информацию об одном сегменте по его ID.

Эндпоинт: GET https://mailganer.com/api/v2/segments/:segment_id\nАвторизация: заголовок Authorization: CodeRequest {{api_key}} (наследуется от коллекции)

Path-параметры

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Поле	Тип	Обяз.	Описание
`segment_id`	int	да	ID сегмента

Пример curl

curl --location --request GET 'https://mailganer.com/api/v2/segments/12345' \\\n--header 'Authorization: CodeRequest {{api_key}}'\n

Примечания

Ответ содержит: title, id, cnt_email, cnt_active_email, created.
Метод не описан в публичной документации.

📄 Документация (раздел API): https://documentation.mailganer.ru/documentation/api

Запускает отправку триггерного письма подписчикам указанного сегмента.

Эндпоинт: POST https://mailganer.com/api/v2/segments/:segment_id/send_trigger/\nАвторизация: заголовок Authorization: CodeRequest {{api_key}} (наследуется от коллекции)\nContent-Type: application/json

Path-параметры

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Поле	Тип	Обяз.	Описание
`segment_id`	int	да	ID сегмента, по которому запускается триггер

Тело запроса

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Поле	Тип	Обяз.	Описание
`trigger_id`	int	да	ID триггера, который необходимо отправить

Пример curl

curl --location --request POST 'https://mailganer.com/api/v2/segments/12345/send_trigger/' \\\n--header 'Authorization: CodeRequest {{api_key}}' \\\n--header 'Content-Type: application/json' \\\n--data-raw '{\n    \"trigger_id\": 34521\n}'\n

Примечания

Метод не описан в публичной документации.

📄 Документация (раздел API): https://documentation.mailganer.ru/documentation/api

Добавляет пользовательскую переменную в указанный список.

Эндпоинт: POST https://mailganer.com/api/v2/user_vars/\nАвторизация: заголовок Authorization: CodeRequest {{api_key}} (наследуется от коллекции)\nContent-Type: application/json

Тело запроса

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Поле	Тип	Обяз.	Описание
`source`	Целое число	✔	ID списка, в который добавляется переменная
`title`	Строка	✔	Название переменной
`type`	Целое число	✔	Тип переменной (допустимые значения — в таблице ниже)
`name`	Строка	—	Имя переменной. Если не задано, формируется автоматически и возвращается в ответе

Пример curl

curl --location 'https://mailganer.com/api/v2/user_vars/' \\\n--header 'Authorization: CodeRequest {{api_key}}' \\\n--header 'Content-Type: application/json' \\\n--data '{\n    \"source\": 1,\n    \"title\": \"Название переменной\",\n    \"type\": 0\n}'\n

Примечания

Значения поля type:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

id типа	Тип переменной	Пример
0	Строка	Текст
1	Целое число	12
2	Вещественное число	1.5
3	Дата	22.07.2021
4	Дата и время	22.07.2021 16:03:00
6	Логический тип	true или false
8	Json-массив	{\"a\": 1, \"b\": \"два\", \"c\": [1, 2]}

Ответ содержит поля: source (ID списка), title (название), name (имя переменной), type (тип), type_text (тип текстом).
\n

📄 Документация: https://documentation.mailganer.ru/documentation/user_var/add

Возвращает список пользовательских переменных списка (или всех списков).

Эндпоинт: GET https://mailganer.com/api/v2/user_vars/\nАвторизация: заголовок Authorization: CodeRequest {{api_key}} (наследуется от коллекции)

Query-параметры

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Поле	Тип	Обяз.	Описание
`source`	Целое число	—	ID списка. Если не указан — возвращаются переменные всех списков

Пример curl

curl --location 'https://mailganer.com/api/v2/user_vars/?source=1' \\\n--header 'Authorization: CodeRequest {{api_key}}'\n

Примечания

Ответ постраничный: count (количество переменных), next / previous (ссылки на соседние страницы, null — если страницы нет), results (массив переменных).
\n
Поля объекта в results: source (ID списка), title (название), name (системное имя для подстановки в шаблонах), type (тип), is_global (false — локальная, true — глобальная переменная).
\n
По умолчанию API отдаёт по 25 записей на страницу.
\n

Значения поля type:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

id типа	Тип переменной	Пример
0	Строка	Текст
1	Целое число	12
2	Вещественное число	1.5
3	Дата	22.07.2021
4	Дата и время	22.07.2021 16:03:00
6	Логический тип	true или false
8	Json-массив	{\"a\": 1, \"b\": \"два\", \"c\": [1, 2]}

📄 Документация: https://documentation.mailganer.ru/documentation/user_var/get

ID списка. Если не указан — переменные всех списков

\n","type":"text/plain"},"key":"source","value":"1"}],"variable":[]}},"response":[{"id":"19b19fb3-b493-b423-8388-0d9990f227d8","name":"Успех (200)","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://mailganer.com/api/v2/user_vars/","protocol":"https","host":["mailganer","com"],"path":["api","v2","user_vars",""],"query":[{"value":"1","key":"source","description":"ID списка. Если не указан — переменные всех списков","disabled":true}]},"description":"Возвращает список пользовательских переменных списка (или всех списков).\n\n**Эндпоинт:** `GET https://mailganer.com/api/v2/user_vars/`\n**Авторизация:** заголовок `Authorization: CodeRequest {{api_key}}` (наследуется от коллекции)\n\n### Query-параметры\n| Поле | Тип | Обяз. | Описание |\n|---|---|---|---|\n| `source` | Целое число | — | ID списка. Если не указан — возвращаются переменные всех списков |\n\n### Пример curl\n```bash\ncurl --location 'https://mailganer.com/api/v2/user_vars/?source=1' \\\n--header 'Authorization: CodeRequest {{api_key}}'\n```\n\n### Примечания\n- Ответ постраничный: `count` (количество переменных), `next` / `previous` (ссылки на соседние страницы, `null` — если страницы нет), `results` (массив переменных).\n- Поля объекта в `results`: `source` (ID списка), `title` (название), `name` (системное имя для подстановки в шаблонах), `type` (тип), `is_global` (`false` — локальная, `true` — глобальная переменная).\n- По умолчанию API отдаёт по 25 записей на страницу.\n- Значения поля `type`:\n\n | id типа | Тип переменной | Пример |\n |---|---|---|\n | 0 | Строка | Текст |\n | 1 | Целое число | 12 |\n | 2 | Вещественное число | 1.5 |\n | 3 | Дата | 22.07.2021 |\n | 4 | Дата и время | 22.07.2021 16:03:00 |\n | 6 | Логический тип | true или false |\n | 8 | Json-массив | {\"a\": 1, \"b\": \"два\", \"c\": [1, 2]} |\n\n📄 Документация: https://documentation.mailganer.ru/documentation/user_var/get"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"value":"application/json","key":"Content-Type"}],"cookie":[],"responseTime":null,"body":"{\n \"count\": 11,\n \"next\": null,\n \"previous\": null,\n \"results\": [\n {\n \"source\": \"1\",\n \"title\": \"Телефон\",\n \"name\": \"phone\",\n \"type\": 0,\n \"is_global\": false\n },\n {\n \"source\": \"1\",\n \"title\": \"Имя\",\n \"name\": \"name\",\n \"type\": 0,\n \"is_global\": false\n },\n {\n \"source\": \"1\",\n \"title\": \"Фамилия\",\n \"name\": \"lastname\",\n \"type\": 0,\n \"is_global\": false\n },\n {\n \"source\": \"1\",\n \"title\": \"Отчество\",\n \"name\": \"patronymic\",\n \"type\": 0,\n \"is_global\": false\n },\n {\n \"source\": \"1\",\n \"title\": \"Дата рождения\",\n \"name\": \"birthday\",\n \"type\": 3,\n \"is_global\": false\n },\n {\n \"source\": \"1\",\n \"title\": \"Пол\",\n \"name\": \"gender\",\n \"type\": 0,\n \"is_global\": false\n },\n {\n \"source\": \"1\",\n \"title\": \"Страна\",\n \"name\": \"country\",\n \"type\": 0,\n \"is_global\": false\n },\n {\n \"source\": \"1\",\n \"title\": \"Город\",\n \"name\": \"city\",\n \"type\": 0,\n \"is_global\": false\n },\n {\n \"source\": \"1\",\n \"title\": \"Дата подписки\",\n \"name\": \"subscribe_date\",\n \"type\": 3,\n \"is_global\": false\n },\n {\n \"source\": 1,\n \"title\": \"float\",\n \"name\": \"float\",\n \"type\": 2,\n \"type_text\": \"Вещественное число\"\n },\n {\n \"source\": 1,\n \"title\": \"datetime\",\n \"name\": \"datetime\",\n \"type\": 4,\n \"type_text\": \"Дата и время\"\n }\n ]\n}"}],"_postman_id":"4dc94701-8033-4164-83f2-01d9b74249ef"}],"id":"f6dd6c68-c54a-432c-8bcd-2c5f44633d13","_postman_id":"f6dd6c68-c54a-432c-8bcd-2c5f44633d13","description":"","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":""}]},"isInherited":true,"source":{"_postman_id":"ad2a6101-55ec-46be-9158-ec0369852183","id":"ad2a6101-55ec-46be-9158-ec0369852183","name":"REST API Mailganer","type":"collection"}}},{"name":"Рассылки","item":[{"name":"Создание рассылки","id":"3ae5e59d-2593-4c4b-8dc8-495755d47fa6","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"POST","header":[],"body":{"mode":"formdata","formdata":[{"key":"api_key","value":"XXX","type":"text"},{"key":"theme","value":"Тема рассылки","type":"text"},{"key":"html-content","value":"%3Ca%20href%3D%22%7B%7B%20unsubscribeUrl%20%7D%7D%22%3EUnsubscribe%20me%3C%2Fa%3E","type":"text"}]},"url":"https://mailganer.com/api/v1/mailing/create/","description":"

Создаёт черновик рассылки — возвращает ссылку на редактирование и public_id.

Эндпоинт: POST https://mailganer.com/api/v1/mailing/create/\nАвторизация: noauth — API-ключ передаётся в теле запроса в поле api_key\nContent-Type: multipart/form-data (form-data)

Тело запроса (form-data)

Поле	Тип	Обяз.	Описание
`api_key`	string	✔	Ключ API из профиля
`name`	string		Название рассылки, максимум 150 символов
`html-content`	string		Вёрстка рассылки
`template_id`	string		UID шаблона со страницы `https://mailganer.com/app/custom-templates/`
`amp-html-content`	string		Вёрстка AMP-рассылки
`zip-content`	string		Ссылка на архив с вёрсткой
`amp-zip-content`	string		Ссылка на архив с AMP-вёрсткой
`theme`	string		Тема рассылки
`from_name`	string		Имя отправителя
`from_email`	string		Имейл отправителя
`segment_id`	int		ID сегмента
`utm_campaign`	string		Если не передано — формируется как `{{year}}{{month}}{{day}}_{{public_id}}` (год, месяц, день отправки и ID рассылки)
`utm_source`	string		Если не передано — `\"mailganer\"`
`utm_medium`	string		Если не передано — `\"email\"`
`user_utms`	JSON-строка		Кастомные UTM-метки, формат `{\"param1\":\"value1\",\"param2\":\"value2\"}`
`variables`	JSON-строка		Динамические переменные, формат `{\"var1\":\"value1\",\"var2\":123}`; имеют приоритет над переменными подписчика

Пример curl

curl --location 'https://mailganer.com/api/v1/mailing/create/' \\\n--form 'api_key=\"XXX\"' \\\n--form 'name=\"Новая рассылка\"' \\\n--form 'theme=\"Theme\"' \\\n--form 'from_email=\"info@example.com\"' \\\n--form 'from_name=\"info@example.com\"' \\\n--form 'utm_campaign=\"summer_sale\"' \\\n--form 'utm_source=\"newsletter\"' \\\n--form 'utm_medium=\"email\"' \\\n--form 'user_utms=\"{\\\"promo\\\":\\\"summer2025\\\",\\\"location\\\":\\\"europe\\\"}\"' \\\n--form 'zip-content=\"https://cdn.mailganer.com/mailing-template/demo.zip\"'\n

Примечания

В вёрстке письма можно одновременно использовать переменные из запроса (variables) и переменные подписчика (например {{name}}); значение, не обязательное для хранения в Mailganer (например delivery_address), можно передать в запросе и подставить как {{delivery_address}}.
При передаче вёрстки в html-content заменить символы: &→%26, \"→%22, \\→%27, <→%3C, >→%3E.
Архив в zip-content — только .zip; размер архива должен быть более 7 Мб; внутри обязателен html-файл.
Поля ответа: status (1 — успех, -1 — нет), status_text (success/error), public_id, step1_url, error.
Возможные значения error: Invalid api key; Invalid http method; Invalid url; file недоступен; Zip-files only is allowed; Filesize must be more than 7 Mb; HTML template file not found; email the sender is not confirmed; segment_id does not exists; Invalid JSON decoded variables: No JSON object could be decoded; HTML and JavaScript are not allowed in variables for security reasons.

📄 Документация: https://documentation.mailganer.ru/documentation/mailing/create

\n","urlObject":{"protocol":"https","path":["api","v1","mailing","create",""],"host":["mailganer","com"],"query":[],"variable":[]}},"response":[{"id":"9d2b5669-a1c7-3ba9-ac5f-0343271752c9","name":"Success","originalRequest":{"auth":{"type":"noauth"},"method":"POST","header":[],"body":{"mode":"formdata","formdata":[{"key":"api_key","value":"XXX","type":"text"},{"key":"theme","value":"Тема рассылки","type":"text"},{"key":"html-content","value":"%3Ca%20href%3D%22%7B%7B%20unsubscribeUrl%20%7D%7D%22%3EUnsubscribe%20me%3C%2Fa%3E","type":"text"}]},"url":"https://mailganer.com/api/v1/mailing/create/","description":"Создаёт черновик рассылки — возвращает ссылку на редактирование и `public_id`.\n\n**Эндпоинт:** `POST https://mailganer.com/api/v1/mailing/create/`\n**Авторизация:** `noauth` — API-ключ передаётся в теле запроса в поле `api_key`\n**Content-Type:** `multipart/form-data` (form-data)\n\n### Тело запроса (form-data)\n| Поле | Тип | Обяз. | Описание |\n|---|---|---|---|\n| `api_key` | string | ✔ | Ключ API из профиля |\n| `name` | string | | Название рассылки, максимум 150 символов |\n| `html-content` | string | | Вёрстка рассылки |\n| `template_id` | string | | UID шаблона со страницы `https://mailganer.com/app/custom-templates/` |\n| `amp-html-content` | string | | Вёрстка AMP-рассылки |\n| `zip-content` | string | | Ссылка на архив с вёрсткой |\n| `amp-zip-content` | string | | Ссылка на архив с AMP-вёрсткой |\n| `theme` | string | | Тема рассылки |\n| `from_name` | string | | Имя отправителя |\n| `from_email` | string | | Имейл отправителя |\n| `segment_id` | int | | ID сегмента |\n| `utm_campaign` | string | | Если не передано — формируется как `{{year}}{{month}}{{day}}_{{public_id}}` (год, месяц, день отправки и ID рассылки) |\n| `utm_source` | string | | Если не передано — `\"mailganer\"` |\n| `utm_medium` | string | | Если не передано — `\"email\"` |\n| `user_utms` | JSON-строка | | Кастомные UTM-метки, формат `{\"param1\":\"value1\",\"param2\":\"value2\"}` |\n| `variables` | JSON-строка | | Динамические переменные, формат `{\"var1\":\"value1\",\"var2\":123}`; имеют приоритет над переменными подписчика |\n\n### Пример curl\n```bash\ncurl --location 'https://mailganer.com/api/v1/mailing/create/' \\\n--form 'api_key=\"XXX\"' \\\n--form 'name=\"Новая рассылка\"' \\\n--form 'theme=\"Theme\"' \\\n--form 'from_email=\"info@example.com\"' \\\n--form 'from_name=\"info@example.com\"' \\\n--form 'utm_campaign=\"summer_sale\"' \\\n--form 'utm_source=\"newsletter\"' \\\n--form 'utm_medium=\"email\"' \\\n--form 'user_utms=\"{\\\"promo\\\":\\\"summer2025\\\",\\\"location\\\":\\\"europe\\\"}\"' \\\n--form 'zip-content=\"https://cdn.mailganer.com/mailing-template/demo.zip\"'\n```\n\n### Примечания\n- В вёрстке письма можно одновременно использовать переменные из запроса (`variables`) и переменные подписчика (например `{{name}}`); значение, не обязательное для хранения в Mailganer (например `delivery_address`), можно передать в запросе и подставить как `{{delivery_address}}`.\n- При передаче вёрстки в `html-content` заменить символы: `&`→`%26`, `\"`→`%22`, `\\`→`%27`, `<`→`%3C`, `>`→`%3E`.\n- Архив в `zip-content` — только `.zip`; размер архива должен быть более 7 Мб; внутри обязателен html-файл.\n- Поля ответа: `status` (1 — успех, -1 — нет), `status_text` (`success`/`error`), `public_id`, `step1_url`, `error`.\n- Возможные значения `error`: `Invalid api key`; `Invalid http method`; `Invalid url`; `file недоступен`; `Zip-files only is allowed`; `Filesize must be more than 7 Mb`; `HTML template file not found`; `email the sender is not confirmed`; `segment_id does not exists`; `Invalid JSON decoded variables: No JSON object could be decoded`; `HTML and JavaScript are not allowed in variables for security reasons`.\n\n📄 Документация: https://documentation.mailganer.ru/documentation/mailing/create"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": 1,\n \"step1_url\": \"https://mailganer.com/app/mailing/step1/155959878052/\",\n \"status_text\": \"success\",\n \"public_id\": 155959878052\n}"},{"id":"19fb246b-fefe-f411-5574-345342fa196b","name":"Error","originalRequest":{"auth":{"type":"noauth"},"method":"POST","header":[],"body":{"mode":"formdata","formdata":[{"key":"api_key","value":"XXX","type":"text"},{"key":"theme","value":"Тема рассылки","type":"text"},{"key":"html-content","value":"%3Ca%20href%3D%22%7B%7B%20unsubscribeUrl%20%7D%7D%22%3EUnsubscribe%20me%3C%2Fa%3E","type":"text"}]},"url":"https://mailganer.com/api/v1/mailing/create/","description":"Создаёт черновик рассылки — возвращает ссылку на редактирование и `public_id`.\n\n**Эндпоинт:** `POST https://mailganer.com/api/v1/mailing/create/`\n**Авторизация:** `noauth` — API-ключ передаётся в теле запроса в поле `api_key`\n**Content-Type:** `multipart/form-data` (form-data)\n\n### Тело запроса (form-data)\n| Поле | Тип | Обяз. | Описание |\n|---|---|---|---|\n| `api_key` | string | ✔ | Ключ API из профиля |\n| `name` | string | | Название рассылки, максимум 150 символов |\n| `html-content` | string | | Вёрстка рассылки |\n| `template_id` | string | | UID шаблона со страницы `https://mailganer.com/app/custom-templates/` |\n| `amp-html-content` | string | | Вёрстка AMP-рассылки |\n| `zip-content` | string | | Ссылка на архив с вёрсткой |\n| `amp-zip-content` | string | | Ссылка на архив с AMP-вёрсткой |\n| `theme` | string | | Тема рассылки |\n| `from_name` | string | | Имя отправителя |\n| `from_email` | string | | Имейл отправителя |\n| `segment_id` | int | | ID сегмента |\n| `utm_campaign` | string | | Если не передано — формируется как `{{year}}{{month}}{{day}}_{{public_id}}` (год, месяц, день отправки и ID рассылки) |\n| `utm_source` | string | | Если не передано — `\"mailganer\"` |\n| `utm_medium` | string | | Если не передано — `\"email\"` |\n| `user_utms` | JSON-строка | | Кастомные UTM-метки, формат `{\"param1\":\"value1\",\"param2\":\"value2\"}` |\n| `variables` | JSON-строка | | Динамические переменные, формат `{\"var1\":\"value1\",\"var2\":123}`; имеют приоритет над переменными подписчика |\n\n### Пример curl\n```bash\ncurl --location 'https://mailganer.com/api/v1/mailing/create/' \\\n--form 'api_key=\"XXX\"' \\\n--form 'name=\"Новая рассылка\"' \\\n--form 'theme=\"Theme\"' \\\n--form 'from_email=\"info@example.com\"' \\\n--form 'from_name=\"info@example.com\"' \\\n--form 'utm_campaign=\"summer_sale\"' \\\n--form 'utm_source=\"newsletter\"' \\\n--form 'utm_medium=\"email\"' \\\n--form 'user_utms=\"{\\\"promo\\\":\\\"summer2025\\\",\\\"location\\\":\\\"europe\\\"}\"' \\\n--form 'zip-content=\"https://cdn.mailganer.com/mailing-template/demo.zip\"'\n```\n\n### Примечания\n- В вёрстке письма можно одновременно использовать переменные из запроса (`variables`) и переменные подписчика (например `{{name}}`); значение, не обязательное для хранения в Mailganer (например `delivery_address`), можно передать в запросе и подставить как `{{delivery_address}}`.\n- При передаче вёрстки в `html-content` заменить символы: `&`→`%26`, `\"`→`%22`, `\\`→`%27`, `<`→`%3C`, `>`→`%3E`.\n- Архив в `zip-content` — только `.zip`; размер архива должен быть более 7 Мб; внутри обязателен html-файл.\n- Поля ответа: `status` (1 — успех, -1 — нет), `status_text` (`success`/`error`), `public_id`, `step1_url`, `error`.\n- Возможные значения `error`: `Invalid api key`; `Invalid http method`; `Invalid url`; `file недоступен`; `Zip-files only is allowed`; `Filesize must be more than 7 Mb`; `HTML template file not found`; `email the sender is not confirmed`; `segment_id does not exists`; `Invalid JSON decoded variables: No JSON object could be decoded`; `HTML and JavaScript are not allowed in variables for security reasons`.\n\n📄 Документация: https://documentation.mailganer.ru/documentation/mailing/create"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"value":"application/json","key":"Content-Type"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": -1,\n \"status_text\": \"error\",\n \"error\": \"Invalid post values\"\n}"}],"_postman_id":"3ae5e59d-2593-4c4b-8dc8-495755d47fa6"},{"name":"Отправка рассылки","id":"bdd6d7e2-ce6e-41bb-a797-c164382374b6","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"public_id\": 155959878052,\n \"datetime_send\": \"16.02.2024 17:00\",\n \"is_chunked\": true,\n \"chunk_size\": 5000,\n \"chunk_timeout\": 30\n}","options":{"raw":{"language":"json"}}},"url":"https://mailganer.com/api/v2/mailing/send/","description":"

Отправляет рассылку — сразу или в запланированное время.

Эндпоинт: POST https://mailganer.com/api/v2/mailing/send/\nАвторизация: заголовок Authorization: CodeRequest {{api_key}} (наследуется от коллекции)\nContent-Type: application/json

Тело запроса

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Поле	Тип	Обяз.	Описание
`public_id`	int	✔	ID рассылки
`datetime_send`	string		Дата/время отправки в формате `DD.MM.YYYY HH:MM`, например `16.02.2024 17:00`
`is_chunked`	bool		Включить распределённую отправку. Для сегментов больше 5 000 получателей. Недоступно при A/Б тестировании темы письма
`chunk_size`	int		Количество подписчиков в одной отправке. Значения вне допустимого диапазона система может скорректировать самостоятельно
`chunk_timeout`	int		Перерыв между отправками. Разрешённые значения: `15`, `30`, `60`, `90` минут

Пример curl

curl --location 'https://mailganer.com/api/v2/mailing/send/' \\\n--header 'Authorization: CodeRequest {{api_key}}' \\\n--header 'Content-Type: application/json' \\\n--data '{\n    \"public_id\": 155959878052,\n    \"datetime_send\": \"16.02.2024 17:00\"\n}'\n

Примечания

Параметры chunk_size и chunk_timeout требуют is_chunked=True (иначе ошибка Parameters 'chunk_size' and 'chunk_timeout' require 'is_chunked=True').
Поля ответа: статус (success), status_text (Mailing has been sent for moderation или Mailing has been sent), error.
Возможные значения ошибок (error / status_text): Mailing has been sent (рассылка отправлена); Mailing is delivered (рассылка доставлена); Mailing has an invalid status for sending (невалидный статус для отправки); Mailing subject is empty (тема пустая); Change default subject name (дефолтная тема); Mailing content is empty (контент пустой); Sender email not verified (email отправителя не верифицирован); Must define unsubscribe link in mailing content (нет ссылки на отписку); Not activate tariff (тариф не активирован); Tariff limit exceeded (превышен тарифный лимит); Parameters 'chunk_size' and 'chunk_timeout' require 'is_chunked=True'.
Возможные ошибки уровня запроса: invalid http method (метод не POST); invalid post values (не задана обязательная переменная); invalid api key (неправильный апи-ключ).

📄 Документация: https://documentation.mailganer.ru/documentation/mailing/send

Возвращает подробную информацию о конкретной рассылке.

Эндпоинт: GET https://mailganer.com/api/v2/mailing/:public_id\nАвторизация: заголовок Authorization: CodeRequest {{api_key}} (наследуется от коллекции)

Path-параметры

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Поле	Тип	Обяз.	Описание
`public_id`	int	✔	ID рассылки

Пример curl

curl --location 'https://mailganer.com/api/v2/mailing/166775985258' \\\n--header 'Authorization: CodeRequest {{api_key}}'\n

Примечания

Поля ответа (json):

public_id (int) — ID рассылки
datetime_send (string) — время отправки (datetime)
send (string) — время отправки
name (string) — название рассылки
subject (string) — тема рассылки
subject2 (string) — вторая тема рассылки (актуально для А/Б-тестов)
segment_name (string) — название сегмента
segment_id (int) — ID сегмента
from_name (string) — имя отправителя
from_email (string) — имейл отправителя
utm_campaign (string) — значение URL-параметра utm_campaign
utm_source (string) — значение URL-параметра utm_source
utm_medium (string) — значение URL-параметра utm_medium
text (string) — HTML-контент письма в виде строки
count_spam (int) — количество жалоб на спам
count_unsubscribe (int) — количество отписок
count_click (int) — количество кликов
count_open (int) — количество открытий
count_delivery (int) — количество доставленных писем
count_sent (int) — количество отправленных писем
webversion (string) — ссылка на вебверсию письма
user_utms (array) — пользовательские переменные
preheader (string) — прехедер письма
clickmap (string) — ссылка на карту кликов

📄 Документация: https://documentation.mailganer.ru/documentation/mailing/get

public_id рассылки вы можете увидеть в личном кабинете, открыв эту рассылку в браузере

\n","type":"text/plain"},"type":"any","value":null,"key":"public_id"}]}},"response":[{"id":"f4c88c40-9d1f-4b01-9c54-805ff2e17bef","name":"Получение информации о рассылке","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://mailganer.com/api/v2/mailing/:public_id","protocol":"https","host":["mailganer","com"],"path":["api","v2","mailing",":public_id"],"variable":[{"key":"public_id","value":null,"description":"public_id рассылки вы можете увидеть в личном кабинете, открыв эту рассылку в браузере"}]}},"status":"Success","code":201,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","name":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"public_id\": 166775985258,\n \"datetime_send\": \"07.11.2022 03:37\",\n \"send\": \"2022-11-07T03:37:02.141548\",\n \"name\": \"Mailing Name\",\n \"subject\": \"Email subject\",\n \"segment_name\": \"Segment Name\",\n \"segment_id\": 7502,\n \"from_name\": \"Sender Name\",\n \"from_email\": \"info@mailganer.com\",\n \"utm_campaign\": \"166775985258\",\n \"utm_source\": \"mailganer\",\n \"utm_medium\": \"email\",\n \"text\": \"HTML Content\",\n \"count_spam\": 1,\n \"count_unsubscribe\": 14,\n \"count_click\": 448,\n \"count_open\": 1489,\n \"count_delivery\": 13348,\n \"webversion\": \"https://click.mailganer.com/webversion/166775985258/\",\n \"user_utms\": {\n \"custom_param_1\": \"{{custom_param_1}}\"\n }\n}"}],"_postman_id":"3a2161b3-9d18-4b3b-9f84-cfd123549469"},{"name":"Получить список рассылок","id":"b27af799-e9f0-42d8-b8c1-31921a14f018","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"body":{"mode":"formdata","formdata":[]},"url":"https://mailganer.com/api/v2/mailing/?start_date=2024-04-01&end_date=2024-04-13","description":"

Возвращает список рассылок за указанный период.

Эндпоинт: GET https://mailganer.com/api/v2/mailing/\nАвторизация: заголовок Authorization: CodeRequest {{api_key}} (наследуется от коллекции)

Query-параметры

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Поле	Тип	Обяз.	Описание
`start_date`	date		Дата начала периода, за который возвращать список рассылок
`end_date`	date		Дата окончания периода, за который возвращать список рассылок

Пример curl

curl --location 'https://mailganer.com/api/v2/mailing/?start_date=2024-04-01&end_date=2024-04-13' \\\n--header 'Authorization: CodeRequest {{api_key}}'\n

Примечания

Поля ответа (json):

count (int) — количество пользователей
next (url) — ссылка на следующую страницу
previous (url) — ссылка на предыдущую страницу
results (json-массив) — список рассылок

Содержимое массива results:

datetime_send (дата и время) — планируемое время отправки
send (дата и время) — время начала отправки
count_sent (int) — получателей в рассылке
count_delivery (int) — доставленных писем
count_spam (int) — жалоб на спам
count_unsubscribe (int) — отписались
count_click (int) — кликнули в рассылке
count_open (int) — открыли
public_id (int) — ID рассылки
Created (дата и время) — дата создания рассылки
name (string) — название рассылки
subject (string) — тема рассылки
subject2 (string) — вторая тема рассылки
preheader (string) — прехедер
segment_name (string) — название сегмента
segment_id (int) — ID сегмента
excluding_segments (int) — ID исключающего сегмента
from_name (string) — имя отправителя
from_email (string) — email отправителя
text — HTML-код верстки письма
webversion (url) — веб-версия письма
clickmap (url) — карта кликов
status_str (string) — статус рассылки

📄 Документация: https://documentation.mailganer.ru/documentation/mailing/get_id

Дата начала периода, за который возвращать список рассылок

\n","type":"text/plain"},"key":"start_date","value":"2024-04-01"},{"description":{"content":"

Дата окончания периода, за который возвращать список рассылок

\n","type":"text/plain"},"key":"end_date","value":"2024-04-13"}],"variable":[]}},"response":[{"id":"a29e09ae-41b4-417b-99d1-322c6157fc60","name":"Ошибка","originalRequest":{"method":"GET","header":[],"body":{"mode":"formdata","formdata":[]},"url":"https://mailganer.com/api/v2/mailing/"},"status":"Unauthorized","code":401,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx/1.16.1"},{"key":"Date","value":"Thu, 03 Aug 2023 16:14:45 GMT"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"close"},{"key":"Content-Language","value":"ru"},{"key":"Vary","value":"Accept, Accept-Language, Cookie, Origin"},{"key":"Allow","value":"GET, HEAD, OPTIONS"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"WWW-Authenticate","value":"CodeRequest"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"error\",\n \"error\": \"Учетные данные не были предоставлены.\"\n}"}],"_postman_id":"b27af799-e9f0-42d8-b8c1-31921a14f018"},{"name":"Статистика по рассылке","id":"757ee17d-410d-4390-b3b1-b3af517fd4cd","request":{"method":"GET","header":[],"url":"https://mailganer.com/api/v2/mailing/:public_id/stat/?start_date=2023-12-11&end_date=2023-12-13","description":"

Возвращает статистику по рассылке — в разрезе дней и суммарно за период.

Эндпоинт: GET https://mailganer.com/api/v2/mailing/:public_id/stat/\nАвторизация: заголовок Authorization: CodeRequest {{api_key}} (наследуется от коллекции)

Path-параметры

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Поле	Тип	Обяз.	Описание
`public_id`	int	✔	ID рассылки

Query-параметры

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Поле	Тип	Обяз.	Описание
`start_date`	string		Дата начала в формате `YYYY-MM-DD`
`end_date`	string		Дата конца в формате `YYYY-MM-DD`

Пример curl

curl --location 'https://mailganer.com/api/v2/mailing/459562475965/stat/?start_date=2023-12-11&end_date=2023-12-13' \\\n--header 'Authorization: CodeRequest {{api_key}}'\n

Примечания

Если параметры не указаны — возвращается общая статистика по рассылке за каждый день, а также суммарная статистика за весь период.
Если один из параметров start_date/end_date не указан — возвращается общая статистика за каждый день плюс суммарная за весь период.
Если указаны обе даты — возвращаются данные за указанный период (включая последний день) в разрезе дней плюс суммарная за период статистика.

Поля ответа (json):

count_sent — отправлено
count_delivery — доставлено
count_spam — пожаловались на спам
count_unsubscribe — отписались
count_click — кликнули
count_open — открыли

📄 Документация: https://documentation.mailganer.ru/documentation/mailing/stat

Дата начала в формате YYYY-MM-DD

\n","type":"text/plain"},"key":"start_date","value":"2023-12-11"},{"description":{"content":"

Дата конца в формате YYYY-MM-DD

\n","type":"text/plain"},"key":"end_date","value":"2023-12-13"}],"variable":[{"type":"any","key":"public_id"}]}},"response":[{"id":"cb9c1890-349c-ce7a-98e7-2220b4532460","name":"Success","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://mailganer.com/api/v2/mailing/:public_id/stat/?start_date=2023-12-11&end_date=2023-12-13","protocol":"https","host":["mailganer","com"],"path":["api","v2","mailing",":public_id","stat",""],"query":[{"key":"start_date","value":"2023-12-11","description":"Дата начала в формате YYYY-MM-DD"},{"key":"end_date","value":"2023-12-13","description":"Дата конца в формате YYYY-MM-DD"}],"variable":[{"key":"public_id"}]},"description":"Возвращает статистику по рассылке — в разрезе дней и суммарно за период.\n\n**Эндпоинт:** `GET https://mailganer.com/api/v2/mailing/:public_id/stat/`\n**Авторизация:** заголовок `Authorization: CodeRequest {{api_key}}` (наследуется от коллекции)\n\n### Path-параметры\n| Поле | Тип | Обяз. | Описание |\n|---|---|---|---|\n| `public_id` | int | ✔ | ID рассылки |\n\n### Query-параметры\n| Поле | Тип | Обяз. | Описание |\n|---|---|---|---|\n| `start_date` | string | | Дата начала в формате `YYYY-MM-DD` |\n| `end_date` | string | | Дата конца в формате `YYYY-MM-DD` |\n\n### Пример curl\n```bash\ncurl --location 'https://mailganer.com/api/v2/mailing/459562475965/stat/?start_date=2023-12-11&end_date=2023-12-13' \\\n--header 'Authorization: CodeRequest {{api_key}}'\n```\n\n### Примечания\n- Если параметры не указаны — возвращается общая статистика по рассылке за каждый день, а также суммарная статистика за весь период.\n- Если один из параметров `start_date`/`end_date` не указан — возвращается общая статистика за каждый день плюс суммарная за весь период.\n- Если указаны обе даты — возвращаются данные за указанный период (включая последний день) в разрезе дней плюс суммарная за период статистика.\n\nПоля ответа (json):\n- `count_sent` — отправлено\n- `count_delivery` — доставлено\n- `count_spam` — пожаловались на спам\n- `count_unsubscribe` — отписались\n- `count_click` — кликнули\n- `count_open` — открыли\n\n📄 Документация: https://documentation.mailganer.ru/documentation/mailing/stat"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"[\n {\n \"2024-06-14\": {\n \"count_sent\": 4907,\n \"count_delivery\": 3683,\n \"count_spam\": 0,\n \"count_unsubscribe\": 0,\n \"count_click\": 0,\n \"count_open\": 0\n }\n },\n {\n \"2024-06-15\": {\n \"count_sent\": 4907,\n \"count_delivery\": 3683,\n \"count_spam\": 0,\n \"count_unsubscribe\": 0,\n \"count_click\": 0,\n \"count_open\": 0\n }\n },\n {\n \"2024-06-16\": {\n \"count_sent\": 4907,\n \"count_delivery\": 3683,\n \"count_spam\": 0,\n \"count_unsubscribe\": 0,\n \"count_click\": 0,\n \"count_open\": 0\n }\n },\n {\n \"2024-06-17\": {\n \"count_sent\": 4907,\n \"count_delivery\": 3683,\n \"count_spam\": 0,\n \"count_unsubscribe\": 0,\n \"count_click\": 0,\n \"count_open\": 0\n }\n },\n {\n \"2024-06-18\": {\n \"count_sent\": 4907,\n \"count_delivery\": 3683,\n \"count_spam\": 0,\n \"count_unsubscribe\": 0,\n \"count_click\": 0,\n \"count_open\": 0\n }\n },\n {\n \"summary\": {\n \"count_sent\": 4907,\n \"count_delivery\": 3683,\n \"count_spam\": 0,\n \"count_unsubscribe\": 1,\n \"count_click\": 47,\n \"count_open\": 265\n }\n }\n]"}],"_postman_id":"757ee17d-410d-4390-b3b1-b3af517fd4cd"}],"id":"a1a8eda9-8919-4b02-b9e7-ef77bb2aede9","_postman_id":"a1a8eda9-8919-4b02-b9e7-ef77bb2aede9","description":"","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":""}]},"isInherited":true,"source":{"_postman_id":"ad2a6101-55ec-46be-9158-ec0369852183","id":"ad2a6101-55ec-46be-9158-ec0369852183","name":"REST API Mailganer","type":"collection"}}},{"name":"Триггеры","item":[{"name":"Отправка триггера","id":"05e525b8-0d19-42db-89a4-9ac12157f472","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"email\": \"test@example.com\",\n \"doi_ok\": true,\n \"ignore_unsubscribed\": true,\n \"ignore_spam\": true,\n \"sender_name\": \"Mailganer\",\n \"sender_email\": \"info@mailganer.com\",\n \"variables\": {\n \"order_id\": 1234,\n \"first_name\": \"Test\",\n \"delivery_address\": \"Москва, Красная площадь, Кремль\",\n \"goods\": [\n {\n \"link\": \"https://domain.ru/products/11021\",\n \"title\": \"Туфли1\",\n \"cost\": \"39500\"\n },\n {\n \"link\": \"https://domain.ru/products/11022\",\n \"title\": \"Туфли2\",\n \"cost\": \"39500\"\n }\n ]\n }\n}","options":{"raw":{"language":"json"}}},"url":"https://mailganer.com/api/v2/triggers/:trigger_id/send/","description":"

Отправляет триггерное письмо (или SMS) конкретному подписчику по его имейлу.

Эндпоинт: POST https://mailganer.com/api/v2/triggers/:trigger_id/send/\nАвторизация: заголовок Authorization: CodeRequest {{api_key}} (наследуется от коллекции)\nContent-Type: application/json

Path-параметры

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Поле	Тип	Обяз.	Описание
`trigger_id`	int	Да	ID триггера

Тело запроса

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Поле	Тип	Обяз.	Описание
`email`	string	Да	Имейл получателя
`phone`	string	Нет	Телефон получателя (для SMS-триггера)
`trigger_content`	string	Нет	Своё содержимое письма (UTF-8), переопределяет контент из кабинета
`trigger_theme`	string	Нет	Своя тема письма (UTF-8), переопределяет тему из кабинета
`ignore_wait`	bool	Нет	Отправить, несмотря на статус «ожидает подтверждения»
`ignore_unsubscribed`	bool	Нет	Отправить, несмотря на статус «отписан»
`ignore_spam`	bool	Нет	Отправить, несмотря на жалобу на спам
`doi_ok`	bool	Нет	Добавить подписчика как «Активный» перед отправкой
`send_now`	bool	Нет	Игнорировать настройку отложенной отправки
`variables`	array/object	Нет	Переменные шаблона письма (одномерные и многомерные массивы)
`update_variables`	bool	Нет	Обновить переменные подписчика (требует активации)
`sender_email`	string	Нет	Свой адрес отправителя (требует `sender_name`)
`sender_name`	string	Нет	Имя отправителя в поле From

Пример curl

curl --location 'https://mailganer.com/api/v2/triggers/1111/send/' \\\n--header 'Authorization: CodeRequest {{api_key}}' \\\n--header 'Content-Type: application/json' \\\n--data-raw '{\n    \"email\": \"test@example.com\"\n}'\n

Примечания

Рекомендуемая частота вызовов — не более 300 в минуту.
variables поддерживает одномерные и многомерные массивы; язык шаблонов — Django-подобный синтаксис с операторами {% for %}, {% if %}.
Нельзя размещать {% for %} или {% if %} между тегами <table> и <td>.
sender_email принимается только если отправитель существует в аккаунте и подтверждён (верифицирован).
По умолчанию doi_ok, ignore_unsubscribed, ignore_spam, update_variables отключены — активация через поддержку.
Ответ: status (1 — отправлено, -1 — ошибка, 0 — системная ошибка), status_text (success/error), result (уникальный ID отправки для запроса статистики), error (описание ошибки).
Возможные ошибки: Invalid post values (нет обязательного параметра), Invalid email value (некорректный имейл), Error api key (неверный ключ), Not activate tariff (тариф не активен), Tariff limit exceeded (исчерпан лимит), Not found trigger api call (у триггера нет события API), Sender email is not activated (отправитель не подтверждён), Trigger not active (триггер отключён), Not in condition for (подписчик не проходит условия).

📄 Документация: https://documentation.mailganer.ru/documentation/trigger/send/v2

ID триггера

\n","type":"text/plain"},"type":"any","value":"","key":"trigger_id"}]}},"response":[{"id":"1e0bfa58-0f31-3595-3500-3237626516db","name":"Успешная отправка","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"email\": \"test@example.com\",\n \"doi_ok\": true,\n \"ignore_unsubscribed\": true,\n \"ignore_spam\": true,\n \"sender_name\": \"Mailganer\",\n \"sender_email\": \"info@mailganer.com\",\n \"variables\": {\n \"order_id\": 1234,\n \"first_name\": \"Test\",\n \"delivery_address\": \"Москва, Красная площадь, Кремль\",\n \"goods\": [\n {\n \"link\": \"https://domain.ru/products/11021\",\n \"title\": \"Туфли1\",\n \"cost\": \"39500\"\n },\n {\n \"link\": \"https://domain.ru/products/11022\",\n \"title\": \"Туфли2\",\n \"cost\": \"39500\"\n }\n ]\n }\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"https://mailganer.com/api/v2/triggers/:trigger_id/send/","protocol":"https","host":["mailganer","com"],"path":["api","v2","triggers",":trigger_id","send",""],"variable":[{"key":"trigger_id","value":"","description":"ID триггера"}]},"description":"Отправляет триггерное письмо (или SMS) конкретному подписчику по его имейлу.\n\n**Эндпоинт:** `POST https://mailganer.com/api/v2/triggers/:trigger_id/send/`\n**Авторизация:** заголовок `Authorization: CodeRequest {{api_key}}` (наследуется от коллекции)\n**Content-Type:** `application/json`\n\n### Path-параметры\n| Поле | Тип | Обяз. | Описание |\n|---|---|---|---|\n| `trigger_id` | int | Да | ID триггера |\n\n### Тело запроса\n| Поле | Тип | Обяз. | Описание |\n|---|---|---|---|\n| `email` | string | Да | Имейл получателя |\n| `phone` | string | Нет | Телефон получателя (для SMS-триггера) |\n| `trigger_content` | string | Нет | Своё содержимое письма (UTF-8), переопределяет контент из кабинета |\n| `trigger_theme` | string | Нет | Своя тема письма (UTF-8), переопределяет тему из кабинета |\n| `ignore_wait` | bool | Нет | Отправить, несмотря на статус «ожидает подтверждения» |\n| `ignore_unsubscribed` | bool | Нет | Отправить, несмотря на статус «отписан» |\n| `ignore_spam` | bool | Нет | Отправить, несмотря на жалобу на спам |\n| `doi_ok` | bool | Нет | Добавить подписчика как «Активный» перед отправкой |\n| `send_now` | bool | Нет | Игнорировать настройку отложенной отправки |\n| `variables` | array/object | Нет | Переменные шаблона письма (одномерные и многомерные массивы) |\n| `update_variables` | bool | Нет | Обновить переменные подписчика (требует активации) |\n| `sender_email` | string | Нет | Свой адрес отправителя (требует `sender_name`) |\n| `sender_name` | string | Нет | Имя отправителя в поле From |\n\n### Пример curl\n```bash\ncurl --location 'https://mailganer.com/api/v2/triggers/1111/send/' \\\n--header 'Authorization: CodeRequest {{api_key}}' \\\n--header 'Content-Type: application/json' \\\n--data-raw '{\n \"email\": \"test@example.com\"\n}'\n```\n\n### Примечания\n- Рекомендуемая частота вызовов — **не более 300 в минуту**.\n- `variables` поддерживает одномерные и многомерные массивы; язык шаблонов — Django-подобный синтаксис с операторами `{% for %}`, `{% if %}`.\n- Нельзя размещать `{% for %}` или `{% if %}` между тегами `` и `

`.\n- `sender_email` принимается только если отправитель существует в аккаунте и подтверждён (верифицирован).\n- По умолчанию `doi_ok`, `ignore_unsubscribed`, `ignore_spam`, `update_variables` отключены — активация через поддержку.\n- Ответ: `status` (1 — отправлено, -1 — ошибка, 0 — системная ошибка), `status_text` (`success`/`error`), `result` (уникальный ID отправки для запроса статистики), `error` (описание ошибки).\n- Возможные ошибки: `Invalid post values` (нет обязательного параметра), `Invalid email value` (некорректный имейл), `Error api key` (неверный ключ), `Not activate tariff` (тариф не активен), `Tariff limit exceeded` (исчерпан лимит), `Not found trigger api call` (у триггера нет события API), `Sender email is not activated` (отправитель не подтверждён), `Trigger not active` (триггер отключён), `Not in condition for` (подписчик не проходит условия).\n\n📄 Документация: https://documentation.mailganer.ru/documentation/trigger/send/v2"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"value":"application/json","key":"Content-Type"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": 1,\n \"updated_variables\": [],\n \"status_text\": \"Success. Complete on 0.453127 sec.\",\n \"result\": 191015674\n}"}],"_postman_id":"05e525b8-0d19-42db-89a4-9ac12157f472"},{"name":"Статистика триггера","id":"527e4224-28a1-4639-be1a-381a48bae4df","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"https://mailganer.com/api/v2/triggers/:trigger_id/stat/?start_date=2022-08-01&end_date=2023-08-03","description":"

Возвращает статистику по триггеру: суммарную или в разрезе дней за период.

Эндпоинт: GET https://mailganer.com/api/v2/triggers/:trigger_id/stat/\nАвторизация: заголовок Authorization: CodeRequest {{api_key}} (наследуется от коллекции)

Path-параметры

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Поле	Тип	Обяз.	Описание
`trigger_id`	int	Да	ID триггера

Query-параметры

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Поле	Тип	Обяз.	Описание
`start_date`	string	Нет	Дата начала в формате `YYYY-MM-DD`
`end_date`	string	Нет	Дата конца в формате `YYYY-MM-DD`

Пример curl

curl --location 'https://mailganer.com/api/v2/triggers/1111/stat/?start_date=2022-08-01&end_date=2023-08-03' \\\n--header 'Authorization: CodeRequest {{api_key}}'\n

Примечания

Без параметров дат — возвращается суммарная статистика по триггеру (объект summary).
Если передан только один из параметров (start_date или end_date) — также возвращается суммарная статистика.
Если переданы оба параметра — данные за указанный период (включая последний день) в разрезе дней плюс блок summary.
Поля статистики: delivered (доставлено), clicked (клики), opened (открытия), not_available (недоступно), unsubscribed (отписки), spammed (жалобы на спам), sent (отправлено).

📄 Документация: https://documentation.mailganer.ru/documentation/trigger/stat/v2

Дата начала в формате YYYY-MM-DD

\n","type":"text/plain"},"key":"start_date","value":"2022-08-01"},{"description":{"content":"

Дата конца в формате YYYY-MM-DD

\n","type":"text/plain"},"key":"end_date","value":"2023-08-03"}],"variable":[{"description":{"content":"

ID триггера

\n","type":"text/plain"},"type":"any","value":"1111","key":"trigger_id"}]}},"response":[{"id":"87be530d-ebc9-4d50-8555-422dcf3a6337","name":"С датой","originalRequest":{"method":"GET","header":[],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":{"raw":"https://mailganer.com/api/v2/triggers/:trigger_id/stat/?start_date=2022-08-01&end_date=2023-08-03","protocol":"https","host":["mailganer","com"],"path":["api","v2","triggers",":trigger_id","stat",""],"query":[{"key":"start_date","value":"2022-08-01","description":"Дата начала"},{"key":"end_date","value":"2023-08-03","description":"Дата конца"}],"variable":[{"key":"trigger_id","value":"1111","description":"ID триггера"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","name":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"2023-08-01\": {\n \"delivered\": 338,\n \"clicked\": 13,\n \"opened\": 60,\n \"not_available\": 4,\n \"unsubscribed\": 1,\n \"spammed\": 0,\n \"sent\": 344\n },\n \"2023-08-02\": {\n \"delivered\": 315,\n \"clicked\": 12,\n \"opened\": 54,\n \"not_available\": 0,\n \"unsubscribed\": 2,\n \"spammed\": 0,\n \"sent\": 316\n },\n \"2023-08-03\": {\n \"delivered\": 369,\n \"clicked\": 13,\n \"opened\": 57,\n \"not_available\": 0,\n \"unsubscribed\": 0,\n \"spammed\": 0,\n \"sent\": 369\n },\n \"summary\": {\n \"delivered\": 1022,\n \"clicked\": 38,\n \"opened\": 171,\n \"not_available\": 4,\n \"unsubscribed\": 3,\n \"spammed\": 0,\n \"sent\": 1029\n }\n}"},{"id":"8900485d-ddad-4ecd-ac44-94e48b685f98","name":"Без даты","originalRequest":{"method":"GET","header":[],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":{"raw":"https://mailganer.com/api/v2/triggers/:trigger_id/send/","protocol":"https","host":["mailganer","com"],"path":["api","v2","triggers",":trigger_id","send",""],"variable":[{"key":"trigger_id","value":null,"description":"ID триггера"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","name":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\r\n \"summary\": {\r\n \"delivered\": 163538,\r\n \"clicked\": 7990,\r\n \"opened\": 57910,\r\n \"not_available\": 584,\r\n \"unsubscribed\": 675,\r\n \"spammed\": 931,\r\n \"sent\": 165341\r\n }\r\n}"},{"id":"84f6498d-2cc2-4c65-a7d4-0fb1d6392a14","name":"Ошибка авторизации","originalRequest":{"method":"GET","header":[],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":{"raw":"https://mailganer.com/api/v2/triggers/:trigger_id/send/?start_date=2022-08-01&end_date=2023-08-03","protocol":"https","host":["mailganer","com"],"path":["api","v2","triggers",":trigger_id","send",""],"query":[{"key":"start_date","value":"2022-08-01","description":"Дата начала"},{"key":"end_date","value":"2023-08-03","description":"Дата конца"}],"variable":[{"key":"trigger_id","value":null,"description":"ID триггера"}]}},"status":"Unauthorized","code":401,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx/1.16.1"},{"key":"Date","value":"Thu, 03 Aug 2023 11:46:30 GMT"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"close"},{"key":"Content-Language","value":"ru"},{"key":"Vary","value":"Accept, Accept-Language, Cookie, Origin"},{"key":"Allow","value":"POST, OPTIONS"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"WWW-Authenticate","value":"CodeRequest"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"error\",\n \"error\": \"Недопустимый токен.\"\n}"},{"id":"e2af8ac6-13b2-4169-a88d-e87485fd00d6","name":"Триггер не найден","originalRequest":{"method":"GET","header":[],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":{"raw":"https://mailganer.com/api/v2/triggers/1111/stat/?start_date=2022-08-01&end_date=2023-08-03","protocol":"https","host":["mailganer","com"],"path":["api","v2","triggers","1111","stat",""],"query":[{"key":"start_date","value":"2022-08-01","description":"Дата начала"},{"key":"end_date","value":"2023-08-03","description":"Дата конца"}]}},"status":"Not Found","code":404,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx/1.16.1"},{"key":"Date","value":"Thu, 03 Aug 2023 11:47:29 GMT"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"close"},{"key":"Vary","value":"Accept, Accept-Language, Cookie, Origin"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"Content-Language","value":"ru"},{"key":"Allow","value":"GET, HEAD, OPTIONS"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"error\",\n \"error\": \"Не найдено.\"\n}"}],"_postman_id":"527e4224-28a1-4639-be1a-381a48bae4df"},{"name":"Получение статистики по отправке триггера","id":"89ece591-45c3-48e2-a2bd-1df6a429705c","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"value":"application/json","key":"Content-Type"}],"body":{"mode":"raw","raw":"{\n \"api_key\": \"{{api_key}}\",\n \"id_list\": [123, 456]\n}"},"url":"https://mailganer.com/api/v1/trigger/id_stat/","description":"

Возвращает статусы доставки по списку ID отправок триггера (пакетно).

Эндпоинт: POST https://mailganer.com/api/v1/trigger/id_stat/\nАвторизация: без авторизации (noauth); API-ключ передаётся в теле запроса в поле api_key\nContent-Type: application/json

Тело запроса

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Поле	Тип	Обяз.	Описание
`api_key`	string	Да	API-ключ (см. https://mailganer.com/app/profile/)
`id_list`	array	Да	Список ID отправок для пакетного получения статусов

Пример curl

curl --location 'https://mailganer.com/api/v1/trigger/id_stat/' \\\n--header 'Content-Type: application/json' \\\n--data '{\n    \"api_key\": \"{{api_key}}\",\n    \"id_list\": [123, 456]\n}'\n

Примечания

Максимум 100 ID в одном запросе.
Ответ: status (1 — успех, -1 — ошибка), status_text (success, error или throttling), result (массив статусов), error (описание ошибки, если есть).
Элемент result: id (ID отправки), status — одно из: Доставлено, Не доставлено, Открыл, Кликнул, Пользователь считает спамом.

📄 Документация: https://documentation.mailganer.ru/documentation/trigger/id_stat

Возвращает список триггеров аккаунта (с пагинацией).

Эндпоинт: GET https://mailganer.com/api/v2/triggers/\nАвторизация: заголовок Authorization: CodeRequest {{api_key}} (наследуется от коллекции)

Пример curl

curl --location 'https://mailganer.com/api/v2/triggers/' \\\n--header 'Authorization: CodeRequest {{api_key}}'\n

Примечания

Ответ постраничный: count (количество триггеров), next (ссылка на следующую страницу), previous (ссылка на предыдущую страницу), results (массив триггеров).
Элемент results: id (идентификатор триггера), name (название, может быть null), sites (списки, с которыми связан триггер).

📄 Документация: https://documentation.mailganer.ru/documentation/triggers

Возвращает подробную информацию (метаданные) о триггере.

Эндпоинт: GET https://mailganer.com/api/v2/triggers/:trigger_id/meta/\nАвторизация: заголовок Authorization: CodeRequest {{api_key}} (наследуется от коллекции)

Path-параметры

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Поле	Тип	Обяз.	Описание
`trigger_id`	int	Да	ID триггера

Пример curl

curl --location 'https://mailganer.com/api/v2/triggers/1111/meta/' \\\n--header 'Authorization: CodeRequest {{api_key}}'\n

Примечания

Возвращаемые поля: name (название, ≤250), group (группа, ≤250), topic (тема письма), sites (ID связанных списков), sites_names (названия списков), event (тип события, ≤100), sender_name (≤255), sender_email (≤255), utm_campaign / utm_source / utm_medium (≤150), user_utms (пользовательские UTM, ≤255), webversion (ссылка на веб-версию, ≤255), html_code (HTML-контент письма), created (дата создания, DD.MM.YYYY HH:MM), first_letter_date (дата первой отправки), last_activate_date (дата последней активации), type (канал: Email, SMS, Viber), active (статус активности True/False).

📄 Документация: https://documentation.mailganer.ru/documentation/trigger/meta/

Создаёт новый триггер в аккаунте.

Эндпоинт: POST https://mailganer.com/api/v2/triggers/create/\nАвторизация: заголовок Authorization: CodeRequest {{api_key}} (наследуется от коллекции)\nContent-Type: application/json

Тело запроса

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Поле	Тип	Обяз.	Описание
`name`	string	Нет*	Название триггера (≤250 символов)
`theme`	string	Нет	Тема письма триггера (≤250 символов)
`sites`	array	Нет	Список ID списков (сегментов)
`html-content`	string	Нет	HTML-вёрстка письма триггера
`zip-content`	string	Нет	Ссылка на архив с вёрсткой (.zip)

* По документации все поля необязательны, но при отсутствии name возвращается ошибка 400 «Это поле обязательно».

Пример curl

curl --location 'https://mailganer.com/api/v2/triggers/create/' \\\n--header 'Authorization: CodeRequest {{api_key}}' \\\n--header 'Content-Type: application/json' \\\n--data '{\n    \"name\": \"Новый триггер\",\n    \"theme\": \"Новый триггер\",\n    \"sites\": [94321],\n    \"html-content\": \"<p>Привет, это пример HTML-содержимого письма.</p>\",\n    \"zip-content\": \"\"\n}'\n

Примечания

При использовании html-content спецсимволы экранируются: &→%26, \"→%22, \\→%27, <→%3C, >→%3E.
Ответ: status (1/success или invalid), status_text (success/invalid), trigger_id (ID созданного триггера), step1_url (ссылка на страницу редактирования), error (объект с ошибками при invalid).
Возможные ошибки: неверный API-ключ; недопустимый HTTP-метод; неверная ссылка zip-content; архив недоступен; формат не .zip; превышен размер архива; в архиве нет HTML-шаблона; неподтверждённый адрес отправителя; несуществующий ID сегмента; превышение длины name (250) или theme (250).

📄 Документация: https://documentation.mailganer.ru/documentation/trigger/create

Привет, это пример HTML-содержимого письма.

\",\n \"zip-content\": \"\"\n}'\n```\n\n### Примечания\n- При использовании `html-content` спецсимволы экранируются: `&`→`%26`, `\"`→`%22`, `\\`→`%27`, `<`→`%3C`, `>`→`%3E`.\n- Ответ: `status` (`1`/`success` или `invalid`), `status_text` (`success`/`invalid`), `trigger_id` (ID созданного триггера), `step1_url` (ссылка на страницу редактирования), `error` (объект с ошибками при `invalid`).\n- Возможные ошибки: неверный API-ключ; недопустимый HTTP-метод; неверная ссылка `zip-content`; архив недоступен; формат не `.zip`; превышен размер архива; в архиве нет HTML-шаблона; неподтверждённый адрес отправителя; несуществующий ID сегмента; превышение длины `name` (250) или `theme` (250).\n\n📄 Документация: https://documentation.mailganer.ru/documentation/trigger/create"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": 1,\n \"step1_url\": \"https://mailganer.com/app/trigger/step1/53223/\",\n \"status_text\": \"success\",\n \"trigger_id\": 16434\n}"},{"id":"ff29fae8-9715-7764-9eba-f900e10735df","name":"Ошибка валидации","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":""},"url":"https://mailganer.com/api/v2/triggers/create/","description":"Создаёт новый триггер в аккаунте.\n\n**Эндпоинт:** `POST https://mailganer.com/api/v2/triggers/create/`\n**Авторизация:** заголовок `Authorization: CodeRequest {{api_key}}` (наследуется от коллекции)\n**Content-Type:** `application/json`\n\n### Тело запроса\n| Поле | Тип | Обяз. | Описание |\n|---|---|---|---|\n| `name` | string | Нет* | Название триггера (≤250 символов) |\n| `theme` | string | Нет | Тема письма триггера (≤250 символов) |\n| `sites` | array | Нет | Список ID списков (сегментов) |\n| `html-content` | string | Нет | HTML-вёрстка письма триггера |\n| `zip-content` | string | Нет | Ссылка на архив с вёрсткой (.zip) |\n\n\\* По документации все поля необязательны, но при отсутствии `name` возвращается ошибка `400` «Это поле обязательно».\n\n### Пример curl\n```bash\ncurl --location 'https://mailganer.com/api/v2/triggers/create/' \\\n--header 'Authorization: CodeRequest {{api_key}}' \\\n--header 'Content-Type: application/json' \\\n--data '{\n \"name\": \"Новый триггер\",\n \"theme\": \"Новый триггер\",\n \"sites\": [94321],\n \"html-content\": \"

Привет, это пример HTML-содержимого письма.

Возвращает историю отправленных имейлов по триггеру (с пагинацией).

Эндпоинт: GET https://mailganer.com/api/v2/triggers/:trigger_id/emails/\nАвторизация: заголовок Authorization: CodeRequest {{api_key}} (наследуется от коллекции)

Path-параметры

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Поле	Тип	Обяз.	Описание
`trigger_id`	int	Да	ID триггера

Query-параметры

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Поле	Тип	Обяз.	Описание
`start_date`	string	Нет	Дата начала в формате `YYYY-MM-DD`
`end_date`	string	Нет	Дата конца в формате `YYYY-MM-DD`

Пример curl

curl --location 'https://mailganer.com/api/v2/triggers/1111/emails/?start_date=2024-08-01&end_date=2024-08-03' \\\n--header 'Authorization: CodeRequest {{api_key}}'\n

Примечания

Без параметров дат — возвращаются все имейлы за всю историю.
Если передан только один из параметров дат — фильтр игнорируется, возвращаются все имейлы.
Оба параметра (start_date и end_date) должны передаваться вместе для фильтрации по периоду.
Ответ постраничный: count (всего имейлов), next (ссылка на следующую страницу), previous (ссылка на предыдущую страницу), results (массив имейлов).
Элемент results: id (ID отправки), queue_date (время постановки в очередь), sended (время отправки, null если не отправлено), email (имейл подписчика), email_id (идентификатор имейла), mg_hash (уникальный хэш подписчика), source_id (ID списка), status (0 — в очереди, 1 — отправлено, 2 — доставлено, -1 — отменено, -2 — не доставлено, -3 — отписался), action (действие: Не открыл / Открыл / Кликнул / Отписался).

📄 Документация: https://documentation.mailganer.ru/documentation/trigger/emails

Дата начала в формате YYYY-MM-DD

\n","type":"text/plain"},"key":"start_date","value":"2024-08-01"},{"description":{"content":"

Дата конца в формате YYYY-MM-DD

\n","type":"text/plain"},"key":"end_date","value":"2024-08-03"}],"variable":[{"type":"any","key":"trigger_id"}]}},"response":[{"id":"6e8fc5bd-94df-c6a1-80e8-52226ebad759","name":"История имейлов","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://mailganer.com/api/v2/triggers/:trigger_id/emails/?start_date=2024-08-01&end_date=2024-08-03","protocol":"https","host":["mailganer","com"],"path":["api","v2","triggers",":trigger_id","emails",""],"query":[{"value":"2024-08-01","key":"start_date","description":"Дата начала в формате YYYY-MM-DD"},{"value":"2024-08-03","key":"end_date","description":"Дата конца в формате YYYY-MM-DD"}],"variable":[{"key":"trigger_id"}]},"description":"Возвращает историю отправленных имейлов по триггеру (с пагинацией).\n\n**Эндпоинт:** `GET https://mailganer.com/api/v2/triggers/:trigger_id/emails/`\n**Авторизация:** заголовок `Authorization: CodeRequest {{api_key}}` (наследуется от коллекции)\n\n### Path-параметры\n| Поле | Тип | Обяз. | Описание |\n|---|---|---|---|\n| `trigger_id` | int | Да | ID триггера |\n\n### Query-параметры\n| Поле | Тип | Обяз. | Описание |\n|---|---|---|---|\n| `start_date` | string | Нет | Дата начала в формате `YYYY-MM-DD` |\n| `end_date` | string | Нет | Дата конца в формате `YYYY-MM-DD` |\n\n### Пример curl\n```bash\ncurl --location 'https://mailganer.com/api/v2/triggers/1111/emails/?start_date=2024-08-01&end_date=2024-08-03' \\\n--header 'Authorization: CodeRequest {{api_key}}'\n```\n\n### Примечания\n- Без параметров дат — возвращаются все имейлы за всю историю.\n- Если передан только один из параметров дат — фильтр игнорируется, возвращаются все имейлы.\n- Оба параметра (`start_date` и `end_date`) должны передаваться вместе для фильтрации по периоду.\n- Ответ постраничный: `count` (всего имейлов), `next` (ссылка на следующую страницу), `previous` (ссылка на предыдущую страницу), `results` (массив имейлов).\n- Элемент `results`: `id` (ID отправки), `queue_date` (время постановки в очередь), `sended` (время отправки, `null` если не отправлено), `email` (имейл подписчика), `email_id` (идентификатор имейла), `mg_hash` (уникальный хэш подписчика), `source_id` (ID списка), `status` (0 — в очереди, 1 — отправлено, 2 — доставлено, -1 — отменено, -2 — не доставлено, -3 — отписался), `action` (действие: Не открыл / Открыл / Кликнул / Отписался).\n\n📄 Документация: https://documentation.mailganer.ru/documentation/trigger/emails"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"value":"application/json","key":"Content-Type"}],"cookie":[],"responseTime":null,"body":"{\n \"count\": 562458,\n \"next\": \"https://mailganer.com/api/v2/triggers/1111/emails/?end_date=2024-08-30&page=2&start_date=2024-08-01\",\n \"previous\": null,\n \"results\": [\n {\n \"id\": 213250918,\n \"queue_date\": \"2024-08-30T10:21:48.397765\",\n \"sended\": null,\n \"email\": \"example1@mail.com\",\n \"email_id\": \"1234567890\",\n \"mg_hash\": \"XXXXXXXXXXXXXXXXXXXXXXXXXXXX\",\n \"source_id\": \"12345\",\n \"status\": 0,\n \"action\": \"Не открыл\"\n }\n ]\n}"}],"_postman_id":"33b530f8-2774-4687-98f5-c34070ba9a39"}],"id":"5acff894-bb6b-460a-b5cf-d22a563d5378","_postman_id":"5acff894-bb6b-460a-b5cf-d22a563d5378","description":"","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":""}]},"isInherited":true,"source":{"_postman_id":"ad2a6101-55ec-46be-9158-ec0369852183","id":"ad2a6101-55ec-46be-9158-ec0369852183","name":"REST API Mailganer","type":"collection"}}},{"name":"Товарные рекомендации","item":[{"name":"Передача оформленных заказов","id":"b2d51855-750c-4ef1-8a8f-414996ba16d2","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"api_key\": \"XXX\", // API-ключ из настроек профиля\n \"source_id\": \"50883\", // ID списка\n \"orders\": [\n {\n \"id\": \"12345\", // номер заказа\n \"status\": \"Новый\", // статус заказа\n \"channel\": \"domain.com\", // канал заказа (website / app / callcenter / offline)\n \"date\": \"1619155834\", // дата заказа, Unix-timestamp\n \"email\": \"email@domain.com\", // имейл покупателя\n \"value\": {\n \"total\": 0.0 // сумма заказа\n },\n \"items\": [\n {\n \"id\": 0, // ID товара\n \"price\": 0.0, // цена товара\n \"quantity\": 0.0, // количество\n \"categories\": [1, 2, 3] // ID категорий товара\n }\n ]\n }\n ]\n}","options":{"raw":{"language":"json"}}},"url":"https://mailganer.com/api/v1/recomend/orders/","description":"

Передаёт оформленные заказы в Mailganer для запуска триггеров с товарными рекомендациями.

Эндпоинт: POST https://mailganer.com/api/v1/recomend/orders/\nАвторизация: без заголовка (noauth) — api_key передаётся в теле запроса (v1)\nContent-Type: application/json

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Поле	Тип	Обяз.	Описание
`api_key`	string	да	API-ключ (из настроек профиля)
`source_id`	int	да	ID списка
`orders`	array	да	Данные о заказах
`orders[].id`	string	—	Номер заказа
`orders[].status`	string	—	Статус заказа (например, «Новый»)
`orders[].channel`	string	—	Канал заказа (website / app / callcenter / offline)
`orders[].date`	string	—	Дата заказа, Unix-timestamp
`orders[].email`	string	—	Имейл покупателя
`orders[].value.total`	float	—	Сумма заказа
`orders[].items`	array	—	Товары заказа
`orders[].items[].id`	int	—	ID товара
`orders[].items[].price`	float	—	Цена товара
`orders[].items[].quantity`	float	—	Количество
`orders[].items[].categories`	array	—	ID категорий товара

Поля ответа

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Поле	Тип	Описание
`status`	int	`1` — триггер отправлен, `-1` — ошибка
`status_text`	string	`success` или `error`
`error`	string	Описание ошибки (при наличии)

Пример curl

curl --location --request POST 'https://mailganer.com/api/v1/recomend/orders/' \\\n--header 'Content-Type: application/json' \\\n--data-raw '{\n    \"api_key\": \"XXX\",\n    \"source_id\": \"50883\",\n    \"orders\": [\n        {\n            \"id\": \"12345\",\n            \"status\": \"Новый\",\n            \"channel\": \"domain.com\",\n            \"date\": \"1619155834\",\n            \"email\": \"email@domain.com\",\n            \"value\": { \"total\": 0.0 },\n            \"items\": [\n                { \"id\": 0, \"price\": 0.0, \"quantity\": 0.0, \"categories\": [1, 2, 3] }\n            ]\n        }\n    ]\n}'\n

Примечания

Метод v1: авторизация не через заголовок — api_key передаётся в теле запроса.
Ответ: status = 1 (триггер отправлен) или -1 (ошибка); status_text = success / error; при ошибке добавляется поле error.
Вёрстка письма-триггера с блоком рекомендаций описана в отдельной инструкции (см. «Триггеры с товарными рекомендациями»).

📄 Документация: https://documentation.mailganer.ru/documentation/recomend/orders

\n","urlObject":{"protocol":"https","path":["api","v1","recomend","orders",""],"host":["mailganer","com"],"query":[],"variable":[]}},"response":[{"id":"e5d549b5-a399-f1f1-0675-faa18c99249a","name":"Success — триггер отправлен","originalRequest":{"auth":{"type":"noauth"},"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"api_key\": \"XXX\", // API-ключ из настроек профиля\n \"source_id\": \"50883\", // ID списка\n \"orders\": [\n {\n \"id\": \"12345\", // номер заказа\n \"status\": \"Новый\", // статус заказа\n \"channel\": \"domain.com\", // канал заказа (website / app / callcenter / offline)\n \"date\": \"1619155834\", // дата заказа, Unix-timestamp\n \"email\": \"email@domain.com\", // имейл покупателя\n \"value\": {\n \"total\": 0.0 // сумма заказа\n },\n \"items\": [\n {\n \"id\": 0, // ID товара\n \"price\": 0.0, // цена товара\n \"quantity\": 0.0, // количество\n \"categories\": [1, 2, 3] // ID категорий товара\n }\n ]\n }\n ]\n}","options":{"raw":{"language":"json"}}},"url":"https://mailganer.com/api/v1/recomend/orders/","description":"Передаёт оформленные заказы в Mailganer для запуска триггеров с товарными рекомендациями.\n\n**Эндпоинт:** `POST https://mailganer.com/api/v1/recomend/orders/`\n**Авторизация:** без заголовка (noauth) — `api_key` передаётся в теле запроса (v1)\n**Content-Type:** `application/json`\n\n| Поле | Тип | Обяз. | Описание |\n|---|---|---|---|\n| `api_key` | string | да | API-ключ (из настроек профиля) |\n| `source_id` | int | да | ID списка |\n| `orders` | array | да | Данные о заказах |\n| `orders[].id` | string | — | Номер заказа |\n| `orders[].status` | string | — | Статус заказа (например, «Новый») |\n| `orders[].channel` | string | — | Канал заказа (website / app / callcenter / offline) |\n| `orders[].date` | string | — | Дата заказа, Unix-timestamp |\n| `orders[].email` | string | — | Имейл покупателя |\n| `orders[].value.total` | float | — | Сумма заказа |\n| `orders[].items` | array | — | Товары заказа |\n| `orders[].items[].id` | int | — | ID товара |\n| `orders[].items[].price` | float | — | Цена товара |\n| `orders[].items[].quantity` | float | — | Количество |\n| `orders[].items[].categories` | array | — | ID категорий товара |\n\n### Поля ответа\n| Поле | Тип | Описание |\n|---|---|---|\n| `status` | int | `1` — триггер отправлен, `-1` — ошибка |\n| `status_text` | string | `success` или `error` |\n| `error` | string | Описание ошибки (при наличии) |\n\n### Пример curl\n```bash\ncurl --location --request POST 'https://mailganer.com/api/v1/recomend/orders/' \\\n--header 'Content-Type: application/json' \\\n--data-raw '{\n \"api_key\": \"XXX\",\n \"source_id\": \"50883\",\n \"orders\": [\n {\n \"id\": \"12345\",\n \"status\": \"Новый\",\n \"channel\": \"domain.com\",\n \"date\": \"1619155834\",\n \"email\": \"email@domain.com\",\n \"value\": { \"total\": 0.0 },\n \"items\": [\n { \"id\": 0, \"price\": 0.0, \"quantity\": 0.0, \"categories\": [1, 2, 3] }\n ]\n }\n ]\n}'\n```\n\n### Примечания\n- Метод **v1**: авторизация не через заголовок — `api_key` передаётся в теле запроса.\n- Ответ: `status` = `1` (триггер отправлен) или `-1` (ошибка); `status_text` = `success` / `error`; при ошибке добавляется поле `error`.\n- Вёрстка письма-триггера с блоком рекомендаций описана в отдельной инструкции (см. «Триггеры с товарными рекомендациями»).\n\n📄 Документация: https://documentation.mailganer.ru/documentation/recomend/orders"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": 1,\n \"status_text\": \"success\"\n}"},{"id":"0679535c-0785-b4d0-12af-d13b98d3df2f","name":"Error — ошибка","originalRequest":{"auth":{"type":"noauth"},"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"api_key\": \"XXX\", // API-ключ из настроек профиля\n \"source_id\": \"50883\", // ID списка\n \"orders\": [\n {\n \"id\": \"12345\", // номер заказа\n \"status\": \"Новый\", // статус заказа\n \"channel\": \"domain.com\", // канал заказа (website / app / callcenter / offline)\n \"date\": \"1619155834\", // дата заказа, Unix-timestamp\n \"email\": \"email@domain.com\", // имейл покупателя\n \"value\": {\n \"total\": 0.0 // сумма заказа\n },\n \"items\": [\n {\n \"id\": 0, // ID товара\n \"price\": 0.0, // цена товара\n \"quantity\": 0.0, // количество\n \"categories\": [1, 2, 3] // ID категорий товара\n }\n ]\n }\n ]\n}","options":{"raw":{"language":"json"}}},"url":"https://mailganer.com/api/v1/recomend/orders/","description":"Передаёт оформленные заказы в Mailganer для запуска триггеров с товарными рекомендациями.\n\n**Эндпоинт:** `POST https://mailganer.com/api/v1/recomend/orders/`\n**Авторизация:** без заголовка (noauth) — `api_key` передаётся в теле запроса (v1)\n**Content-Type:** `application/json`\n\n| Поле | Тип | Обяз. | Описание |\n|---|---|---|---|\n| `api_key` | string | да | API-ключ (из настроек профиля) |\n| `source_id` | int | да | ID списка |\n| `orders` | array | да | Данные о заказах |\n| `orders[].id` | string | — | Номер заказа |\n| `orders[].status` | string | — | Статус заказа (например, «Новый») |\n| `orders[].channel` | string | — | Канал заказа (website / app / callcenter / offline) |\n| `orders[].date` | string | — | Дата заказа, Unix-timestamp |\n| `orders[].email` | string | — | Имейл покупателя |\n| `orders[].value.total` | float | — | Сумма заказа |\n| `orders[].items` | array | — | Товары заказа |\n| `orders[].items[].id` | int | — | ID товара |\n| `orders[].items[].price` | float | — | Цена товара |\n| `orders[].items[].quantity` | float | — | Количество |\n| `orders[].items[].categories` | array | — | ID категорий товара |\n\n### Поля ответа\n| Поле | Тип | Описание |\n|---|---|---|\n| `status` | int | `1` — триггер отправлен, `-1` — ошибка |\n| `status_text` | string | `success` или `error` |\n| `error` | string | Описание ошибки (при наличии) |\n\n### Пример curl\n```bash\ncurl --location --request POST 'https://mailganer.com/api/v1/recomend/orders/' \\\n--header 'Content-Type: application/json' \\\n--data-raw '{\n \"api_key\": \"XXX\",\n \"source_id\": \"50883\",\n \"orders\": [\n {\n \"id\": \"12345\",\n \"status\": \"Новый\",\n \"channel\": \"domain.com\",\n \"date\": \"1619155834\",\n \"email\": \"email@domain.com\",\n \"value\": { \"total\": 0.0 },\n \"items\": [\n { \"id\": 0, \"price\": 0.0, \"quantity\": 0.0, \"categories\": [1, 2, 3] }\n ]\n }\n ]\n}'\n```\n\n### Примечания\n- Метод **v1**: авторизация не через заголовок — `api_key` передаётся в теле запроса.\n- Ответ: `status` = `1` (триггер отправлен) или `-1` (ошибка); `status_text` = `success` / `error`; при ошибке добавляется поле `error`.\n- Вёрстка письма-триггера с блоком рекомендаций описана в отдельной инструкции (см. «Триггеры с товарными рекомендациями»).\n\n📄 Документация: https://documentation.mailganer.ru/documentation/recomend/orders"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"value":"application/json","key":"Content-Type"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": -1,\n \"status_text\": \"error\",\n \"error\": \"Описание ошибки\"\n}"}],"_postman_id":"b2d51855-750c-4ef1-8a8f-414996ba16d2"},{"name":"Триггеры с товарными рекомендациями","id":"34305371-00a5-c6c0-b15a-5c6650c0aa9e","request":{"method":"GET","header":[],"url":"https://documentation.mailganer.ru/documentation/recomend-layout-guide","description":"

Инструкция по подготовке вёрстки письма-триггера с блоком товарных рекомендаций.

Эндпоинт: отдельного HTTP-эндпоинта у этой страницы нет — это руководство по вёрстке. Данные о заказах/покупках передаются методами «Передача оформленных заказов» (POST https://mailganer.com/api/v1/recomend/orders/) и «Передача RFM-сегмента» (POST https://mailganer.com/api/v2/recomend/orders/); данная страница описывает, как сверстать HTML-шаблон, в который движок подставит товары. URL запроса указывает на саму страницу документации.\nАвторизация: —

Переменные товара (`product`)

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Переменная	Описание
`{{ product.id }}`	ID товара
`{{ product.name }}`	Название
`{{ product.description }}`	Описание
`{{ product.barcode }}`	Штрихкод
`{{ product.price }}`	Цена (формат «10 500»)
`{{ product.oldprice }}`	Старая цена (до скидки)
`{{ product.currency }}`	Валюта
`{{ product.url }}`	Ссылка на товар
`{{ product.image_url }}`	Ссылка на изображение
`{{ product.brand }}`	Бренд
`{{ product.amount }}`	Количество

Массивы и служебные переменные цикла

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Переменная	Описание
`s_products`	Товары-источники (причина рекомендации, например из корзины / просмотренные)
`r_products`	Рекомендованные товары
`{{ forloop.first }}`	Первая итерация цикла
`{{ forloop.last }}`	Последняя итерация цикла
`{{ forloop.counter }}`	Номер текущей итерации

Пример вёрстки

<html>\n <body>\n   ...\n   <h2>Товары в корзине</h2>\n\n   {% for product in s_products %}\n   <div>\n     <p><a href=\"{{ product.url }}\"><img src=\"{{ product.image_url }}\"/></a></p>\n     <p>{{ product.name }}, {{ product.amount }} шт., {{ product.price }} руб.</p>\n   </div>\n   {% endfor %}\n\n   <h2>Рекомендуем посмотреть</h2>\n\n   {% for product in r_products %}\n   <div>\n     <p><a href=\"{{ product.url }}\"><img src=\"{{ product.image_url }}\"/></a></p>\n     <p>{{ product.name }}, {{ product.price }} руб.</p>\n   </div>\n   {% endfor %}\n   ...\n </body>\n</html>\n

Примечания

Важно: не вставляйте операторы {% for %} или {% if %} между тегами <table> и <td> — иначе операторы автоматически переносятся перед <table> и вёрстка ломается.
Нужны два цикла: один — по товарам-причинам рекомендации (s_products), второй — по рекомендованным товарам (r_products).
Условный вывод (например, старой цены) — через {% if product.oldprice %}...{% endif %}.

📄 Документация: https://documentation.mailganer.ru/documentation/recomend-layout-guide

Передаёт данные о покупках для расчёта RFM-сегмента подписчиков.

Эндпоинт: POST https://mailganer.com/api/v2/recomend/orders/\nАвторизация: заголовок Authorization: CodeRequest {{api_key}} (v2, наследуется от коллекции)\nContent-Type: application/json

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Поле	Тип	Обяз.	Описание
`source_id`	int	да	ID списка
`orders`	array	да	Данные о заказах
`orders[].product_id`	string	да	Номер заказа
`orders[].date`	date	да	Дата покупки (формат `ДД.ММ.ГГГГ`)
`orders[].email`	string	да	Имейл покупателя
`orders[].amount`	int	да	Стоимость покупки

Пример curl

curl --location --request POST 'https://mailganer.com/api/v2/recomend/orders/' \\\n--header 'Authorization: CodeRequest {{api_key}}' \\\n--header 'Content-Type: application/json' \\\n--data-raw '{\n    \"source_id\": \"9345100\",\n    \"orders\": [\n        {\n            \"product_id\": \"35463453\",\n            \"date\": \"01.03.2024\",\n            \"email\": \"test@gmail.com\",\n            \"amount\": 4564\n        }\n    ]\n}'\n

Примечания

Метод v2: авторизация через заголовок Authorization: CodeRequest {{api_key}} (наследуется от коллекции). На самой странице документации авторизация отдельно не расписана; используется общий для v2-методов заголовок.
api_key в теле запроса не передаётся (в отличие от v1-метода «Передача оформленных заказов»).
Пример ответа в документации не приведён.

📄 Документация: https://documentation.mailganer.ru/documentation/recomend/rfm_segment

Создаёт нового пользователя (личный кабинет) в системе Mailganer.

Эндпоинт: POST https://mailganer.com/api/v2/users/\nАвторизация: заголовок Authorization: CodeRequest {{api_key}} (наследуется от коллекции)\nContent-Type: application/json

Параметры запроса

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Поле	Тип	Обяз.	Описание
`first_name`	string	да	Имя пользователя
`email`	string	да	Имейл пользователя
`phone`	string	нет	Телефон

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

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Поле	Тип	Описание
`id`	integer	ID пользователя
`username`	string	Логин для авторизации
`fullname`	string	Полное имя пользователя
`email`	string	Имейл
`phone`	string	Телефон
`code_request`	string	Токен доступа к API
`autologin`	string	Код автологина (авторизация на сайте)

Пример curl

curl --location --request POST 'https://mailganer.com/api/v2/users/' \\\n--header 'Authorization: CodeRequest {{api_key}}' \\\n--header 'Content-Type: application/json' \\\n--data-raw '{\n    \"first_name\": \"Федор\",\n    \"email\": \"test@example.com\",\n    \"phone\": \"+79123456789\"\n}'\n

Примечания

Данная группа методов по умолчанию отключена. Для получения доступа обратитесь на api@mailganer.com.

📄 Документация: https://documentation.mailganer.ru/documentation/users

Возвращает ссылку на оплату для пополнения баланса пользователя.

Эндпоинт: POST https://mailganer.com/api/v2/pay/\nАвторизация: заголовок Authorization: CodeRequest {{api_key}} (наследуется от коллекции)\nContent-Type: application/json

Параметры запроса

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Поле	Тип	Обяз.	Описание
`id`	integer	да	ID пользователя
`summ`	integer	да	Сумма пополнения
`payment_type`	string	да	Тип оплаты: `card` или `invoice`
`requisites`	array	нет	Реквизиты; обязателен при `payment_type=invoice`

Поля объекта `requisites` (при `payment_type=invoice`)

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Поле	Тип	Обяз.	Описание
`inn`	string	да	ИНН
`bic`	string	да	БИК
`rs`	string	да	Расчётный счёт
`kpp`	string	да	КПП
`name_org`	string	да	Название организации
`address_org`	string	да	Адрес организации

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

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Поле	Тип	Описание
`url`	string	Ссылка на оплату

Пример curl

curl --location --request POST 'https://mailganer.com/api/v2/pay/' \\\n--header 'Authorization: CodeRequest {{api_key}}' \\\n--header 'Content-Type: application/json' \\\n--data-raw '{\n    \"id\": 12345,\n    \"summ\": 1000,\n    \"payment_type\": \"card\"\n}'\n

Примечания

Данная группа методов по умолчанию отключена. Для получения доступа обратитесь на api@mailganer.com.
Для оплаты по счёту (payment_type=invoice) необходимо передать массив requisites со всеми полями реквизитов.

📄 Документация: https://documentation.mailganer.ru/documentation/users/payment

Изменяет параметры пользователя по его ID.

Эндпоинт: PATCH https://mailganer.com/api/v2/users/:id/\nАвторизация: заголовок Authorization: CodeRequest {{api_key}} (наследуется от коллекции)\nContent-Type: application/json

Path-параметры

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Поле	Тип	Обяз.	Описание
`id`	integer	да	ID пользователя

Параметры запроса

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Поле	Тип	Обяз.	Описание
`is_access_api_doi`	boolean	нет	Флаг доступа к API DOI (поле присутствует в запросе)

Пример curl

curl --location --request PATCH 'https://mailganer.com/api/v2/users/:id/' \\\n--header 'Authorization: CodeRequest {{api_key}}' \\\n--header 'Content-Type: application/json' \\\n--data-raw '{\n    \"is_access_api_doi\": true\n}'\n

Примечания

Метод не описан в публичной документации.

ID пользователя

\n","type":"text/plain"},"type":"any","value":"","key":"id"}]}},"response":[],"_postman_id":"c81e4415-0371-45ed-8ad6-d1acdad667e9"},{"name":"Получить информацию о пользователе","id":"8b336e55-3937-4348-8f69-0568e060dfaf","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://mailganer.com/api/v2/users/:id/","description":"

Возвращает информацию о пользователе по его ID.

Эндпоинт: GET https://mailganer.com/api/v2/users/:id/\nАвторизация: заголовок Authorization: CodeRequest {{api_key}} (наследуется от коллекции)

Path-параметры

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Поле	Тип	Обяз.	Описание
`id`	integer	да	ID пользователя

Пример curl

curl --location --request GET 'https://mailganer.com/api/v2/users/:id/' \\\n--header 'Authorization: CodeRequest {{api_key}}'\n

Примечания

Метод не описан в публичной документации.

ID пользователя

\n","type":"text/plain"},"type":"any","value":"","key":"id"}]}},"response":[],"_postman_id":"8b336e55-3937-4348-8f69-0568e060dfaf"},{"name":"Получение токена другого пользователя","id":"268a7835-3c40-4059-a5fa-0cdb7a32f442","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":""}]},"isInherited":false},"method":"POST","header":[{"value":"application/json","key":"Content-Type"}],"body":{"mode":"raw","raw":"{\n \"username\": \"test@mailganer.com\",\n \"password\": \"cb61c634\"\n}","options":{"raw":{"language":"json"}}},"url":"https://mailganer.com/api/auth/","description":"

Возвращает API-токен и ID пользователя по логину и паролю (получение токена другого пользователя).

Эндпоинт: POST https://mailganer.com/api/auth/\nАвторизация: заголовок Authorization: CodeRequest {{api_key}}\nContent-Type: application/json

Параметры запроса

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Поле	Тип	Обяз.	Описание
`username`	string (email)	да	Логин (имейл)
`password`	string	да	Пароль

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

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Поле	Тип	Описание
`api_key`	string	Токен доступа к API
`id`	integer	ID пользователя

Пример curl

curl --location --request POST 'https://mailganer.com/api/auth/' \\\n--header 'Authorization: CodeRequest {{api_key}}' \\\n--header 'Content-Type: application/json' \\\n--data-raw '{\n    \"username\": \"test@mailganer.com\",\n    \"password\": \"cb61c634\"\n}'\n

Примечания

Данная группа методов по умолчанию отключена. Для получения доступа обратитесь на api@mailganer.com.
В публичной документации эндпоинт указан как POST https://mailganer.com/api/v2/auth/; в данном запросе используется POST https://mailganer.com/api/auth/.

📄 Документация: https://documentation.mailganer.ru/documentation/auth

\n","urlObject":{"protocol":"https","path":["api","auth",""],"host":["mailganer","com"],"query":[],"variable":[]}},"response":[],"_postman_id":"268a7835-3c40-4059-a5fa-0cdb7a32f442"},{"name":"Получить список пользователей","id":"ab41f53e-baa6-4a90-b8de-5eff17a8c663","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://mailganer.com/api/v2/users/","description":"

Возвращает список пользователей.

Эндпоинт: GET https://mailganer.com/api/v2/users/\nАвторизация: заголовок Authorization: CodeRequest {{api_key}} (наследуется от коллекции)

Пример curl

curl --location --request GET 'https://mailganer.com/api/v2/users/' \\\n--header 'Authorization: CodeRequest {{api_key}}'\n

Примечания

Метод не описан в публичной документации.

Возвращает баланс личного кабинета Mailganer.

Эндпоинт: GET https://mailganer.com/api/v2/users/get_balance/\nАвторизация: заголовок Authorization: CodeRequest {{api_key}} (наследуется от коллекции)

Параметры запроса

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Поле	Тип	Обяз.	Описание
`api_key`	string	да	API-ключ от личного кабинета Mailganer

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

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Поле	Тип	Описание
`balance`	integer	Баланс личного кабинета

Пример curl

curl --location --request GET 'https://mailganer.com/api/v2/users/get_balance/' \\\n--header 'Authorization: CodeRequest 54654768d9897654456wergdd5' \\\n--form 'api_key=\"54654768d9897654456wergdd5\"'\n

Примечания

Данная группа методов по умолчанию отключена. Для получения доступа обратитесь на api@mailganer.com.

📄 Документация: https://documentation.mailganer.ru/documentation/users/balance

Документация по SMTP методам находится в отдельном разделе:

https://documenter.getpostman.com/view/26779685/2s93RZM9in#intro

В качестве хоста используйте

smtp.mailganer.com для SMTP методов

xml.mailganer.com для пакетных методов

\n","auth":{"type":"noauth","isInherited":false},"event":[{"listen":"prerequest","script":{"id":"ee705995-90a7-4e5a-81e0-985859daae1d","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"86a000f1-1700-4636-85ff-df1085d262aa","type":"text/javascript","exec":[""]}}],"_postman_id":"e078058a-3a22-484a-890e-f3a46b7d7b01"},{"name":"Теги","item":[{"name":"Добавление тега","id":"243fe354-c1dc-4848-ae23-682d0953eb9c","request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"name\": \"название_тега\"\n}","options":{"raw":{"language":"json"}}},"url":"https://mailganer.com/api/v2/tags/","description":"

Добавляет новый тег.

Эндпоинт: POST https://mailganer.com/api/v2/tags/\nАвторизация: заголовок Authorization: CodeRequest {{api_key}} (наследуется от коллекции)\nContent-Type: application/json

Тело запроса

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Поле	Тип	Обяз.	Описание
`name`	Строка	✔	Имя тега. Длина не более 140 символов

Пример curl

curl --location 'https://mailganer.com/api/v2/tags/' \\\n--header 'Authorization: CodeRequest {{api_key}}' \\\n--header 'Content-Type: application/json' \\\n--data '{\n    \"name\": \"название_тега\"\n}'\n

Примечания

Ответ содержит поля: id (идентификатор тега), name (имя тега).
Возможные ошибки:
- 400 — The selected tag name is already in use — тег с таким названием уже есть в системе.
- 400 — The tag name must not exceed 140 characters — длина name более 140 символов.
\n

📄 Документация: https://documentation.mailganer.ru/documentation/tags/add

Возвращает список тегов.

Эндпоинт: GET https://mailganer.com/api/v2/tags/\nАвторизация: заголовок Authorization: CodeRequest {{api_key}} (наследуется от коллекции)

Пример curl

curl --location 'https://mailganer.com/api/v2/tags/' \\\n--header 'Authorization: CodeRequest {{api_key}}'\n

Примечания

Ответ постраничный: count (количество тегов), next / previous (ссылки на соседние страницы), results (массив тегов).
Поля объекта в results: id (идентификатор тега), name (название тега).

📄 Документация: https://documentation.mailganer.ru/documentation/tags/get

Возвращает HTML-вёрстку шаблона по его ID.

Эндпоинт: GET https://mailganer.com/api/v2/template/:template_id/\nАвторизация: заголовок Authorization: CodeRequest {{api_key}} (наследуется от коллекции)

Параметры пути

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Поле	Тип	Обяз.	Описание
`template_id`	Строка (UID)	—	ID шаблона. Оставьте пустым, чтобы получить ID и названия всех шаблонов

Пример curl

curl --location 'https://mailganer.com/api/v2/template/4f848a39-136b-42e7-9ba8-e4b4a9dadbe2/' \\\n--header 'Authorization: CodeRequest {{api_key}}'\n

Примечания

ID шаблона можно взять из URL при просмотре шаблона в разделе «Шаблоны» (https://mailganer.com/app/custom-templates/). Пример URL: https://mailganer.com/app/custom-template/4f848a39-136b-42e7-9ba8-e4b4a9dadbe2/, где 4f848a39-136b-42e7-9ba8-e4b4a9dadbe2 — искомый UID шаблона.
Успешный ответ (200) содержит поле text с HTML-вёрсткой шаблона.
Возможные ошибки:
- 401 Unauthorized — не предоставлен или неверный ключ API от личного кабинета.
- 403 Forbidden — у пользователя нет доступа к запрашиваемому шаблону.
- 404 Not Found — шаблон с указанным ID не найден.
\n

📄 Документация: https://documentation.mailganer.ru/documentation/templates

Запускает асинхронную задачу на формирование файла с данными аккаунта (выгрузка списка/сегмента или отчёт по рассылке).

Эндпоинт: POST https://mailganer.com/api/v2/tasks/emails_report\nАвторизация: заголовок Authorization: CodeRequest {{api_key}} (наследуется от коллекции)\nContent-Type: application/json

Параметры тела

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Поле	Тип	Обяз.	Описание
`file_type`	string	Да	Формат файла: `csv` или `xlsx`
`site_id`	int	Нет*	ID списка — выгрузить всех подписчиков списка
`segment_id`	int	Нет*	ID сегмента — выгрузить подписчиков сегмента
`mailing_id`	int	Нет*	ID рассылки (требует `mailing_report_type`)
`mailing_report_type`	string	Нет	Тип отчёта по рассылке: `general_mailing_report` — общий отчёт, `clicks` — отчёт по кликам
`start_date`	string	Нет	Фильтр по дате от (дата создания подписчика), формат `YYYY-MM-DD`
`end_date`	string	Нет	Фильтр по дате до (дата создания подписчика), формат `YYYY-MM-DD`

* Нужно передать ровно одну группу: site_id, segment_id или mailing_id.

Пример curl

curl --location --request POST 'https://mailganer.com/api/v2/tasks/emails_report' \\\n--header 'Authorization: CodeRequest {{api_key}}' \\\n--header 'Content-Type: application/json' \\\n--data-raw '{\n    \"mailing_id\": 177022020521,\n    \"mailing_report_type\": \"general_mailing_report\",\n    \"file_type\": \"csv\"\n}'\n

Примечания

Метод запускает асинхронную задачу; в ответе возвращается task_id, state и task_type.
Параметры site_id, segment_id и mailing_id взаимоисключающие — их нельзя комбинировать (иначе ошибка Request cannot contain parameters from different report types...).
Для mailing_id обязателен mailing_report_type (иначе mailing_id is required for mailing_report_type parameter).
Фильтры по датам (start_date/end_date) применяются к дате создания подписчика; для отчётов по рассылке игнорируются.
Для использования метода в аккаунте должно быть включено ограничение доступа к API по IP-адресам (иначе 403).
Порядок работы с отчётами: 1) создать задачу этим методом → получить task_id; 2) опрашивать статус GET /api/v2/tasks/:task_id, пока state не станет COMPLETED; 3) скачать файл GET /api/v2/tasks/:task_id/download_file.

📄 Документация: https://documentation.mailganer.ru/documentation/task/create

Возвращает текущий статус задачи на формирование отчёта по её идентификатору.

Эндпоинт: GET https://mailganer.com/api/v2/tasks/:task_id\nАвторизация: заголовок Authorization: CodeRequest {{api_key}} (наследуется от коллекции)

Параметры пути

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Поле	Тип	Обяз.	Описание
`task_id`	string	Да	UUID задачи, полученный при её создании

Пример curl

curl --location --request GET 'https://mailganer.com/api/v2/tasks/:task_id' \\\n--header 'Authorization: CodeRequest {{api_key}}'\n

Примечания

Поля ответа: id — UUID задачи; state — статус; task_type — тип отчёта (DOWNLOAD_SITE_EMAILS, DOWNLOAD_SEGMENT, DOWNLOAD_MAILING_REPORT и т.п.).
Значения state: IN_PROGRESS — выполняется; COMPLETED — успешно завершена, файл готов к скачиванию; FAILED — ошибка формирования.
Опрашивайте метод, пока state не станет COMPLETED, затем скачайте файл через GET /api/v2/tasks/:task_id/download_file.
Если задача не найдена — ответ с ошибкой Task by id=... not found.
Для использования метода в аккаунте должно быть включено ограничение доступа к API по IP-адресам (иначе 403).

📄 Документация: https://documentation.mailganer.ru/documentation/task/status

\n","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":""}]},"isInherited":true,"source":{"_postman_id":"ad2a6101-55ec-46be-9158-ec0369852183","id":"ad2a6101-55ec-46be-9158-ec0369852183","name":"REST API Mailganer","type":"collection"}},"urlObject":{"protocol":"https","path":["api","v2","tasks",":task_id"],"host":["mailganer","com"],"query":[],"variable":[{"id":"262def07-431c-4cff-806c-11aee1e50328","type":"any","key":"task_id"}]}},"response":[{"id":"7af8c967-8d4d-cfe5-16d3-562417c58894","name":"Success — выполняется","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://mailganer.com/api/v2/tasks/:task_id","protocol":"https","host":["mailganer","com"],"path":["api","v2","tasks",":task_id"],"variable":[{"id":"262def07-431c-4cff-806c-11aee1e50328","key":"task_id"}]},"description":"Возвращает текущий статус задачи на формирование отчёта по её идентификатору.\n\n**Эндпоинт:** `GET https://mailganer.com/api/v2/tasks/:task_id`\n**Авторизация:** заголовок `Authorization: CodeRequest {{api_key}}` (наследуется от коллекции)\n\n### Параметры пути\n| Поле | Тип | Обяз. | Описание |\n|---|---|---|---|\n| `task_id` | string | Да | UUID задачи, полученный при её создании |\n\n### Пример curl\n```bash\ncurl --location --request GET 'https://mailganer.com/api/v2/tasks/:task_id' \\\n--header 'Authorization: CodeRequest {{api_key}}'\n```\n\n### Примечания\n- Поля ответа: `id` — UUID задачи; `state` — статус; `task_type` — тип отчёта (`DOWNLOAD_SITE_EMAILS`, `DOWNLOAD_SEGMENT`, `DOWNLOAD_MAILING_REPORT` и т.п.).\n- Значения `state`: `IN_PROGRESS` — выполняется; `COMPLETED` — успешно завершена, файл готов к скачиванию; `FAILED` — ошибка формирования.\n- Опрашивайте метод, пока `state` не станет `COMPLETED`, затем скачайте файл через `GET /api/v2/tasks/:task_id/download_file`.\n- Если задача не найдена — ответ с ошибкой `Task by id=... not found`.\n- Для использования метода в аккаунте должно быть включено ограничение доступа к API по IP-адресам (иначе `403`).\n\n📄 Документация: https://documentation.mailganer.ru/documentation/task/status"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"{\n \"id\": \"a39929f4-dac8-4f5d-8d02-82c945623856\",\n \"state\": \"IN_PROGRESS\",\n \"task_type\": \"DOWNLOAD_MAILING_REPORT\"\n}"},{"id":"b2bf73ec-b632-6f42-c99d-977d3e50fff3","name":"Success — завершена","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://mailganer.com/api/v2/tasks/:task_id","protocol":"https","host":["mailganer","com"],"path":["api","v2","tasks",":task_id"],"variable":[{"id":"262def07-431c-4cff-806c-11aee1e50328","key":"task_id"}]},"description":"Возвращает текущий статус задачи на формирование отчёта по её идентификатору.\n\n**Эндпоинт:** `GET https://mailganer.com/api/v2/tasks/:task_id`\n**Авторизация:** заголовок `Authorization: CodeRequest {{api_key}}` (наследуется от коллекции)\n\n### Параметры пути\n| Поле | Тип | Обяз. | Описание |\n|---|---|---|---|\n| `task_id` | string | Да | UUID задачи, полученный при её создании |\n\n### Пример curl\n```bash\ncurl --location --request GET 'https://mailganer.com/api/v2/tasks/:task_id' \\\n--header 'Authorization: CodeRequest {{api_key}}'\n```\n\n### Примечания\n- Поля ответа: `id` — UUID задачи; `state` — статус; `task_type` — тип отчёта (`DOWNLOAD_SITE_EMAILS`, `DOWNLOAD_SEGMENT`, `DOWNLOAD_MAILING_REPORT` и т.п.).\n- Значения `state`: `IN_PROGRESS` — выполняется; `COMPLETED` — успешно завершена, файл готов к скачиванию; `FAILED` — ошибка формирования.\n- Опрашивайте метод, пока `state` не станет `COMPLETED`, затем скачайте файл через `GET /api/v2/tasks/:task_id/download_file`.\n- Если задача не найдена — ответ с ошибкой `Task by id=... not found`.\n- Для использования метода в аккаунте должно быть включено ограничение доступа к API по IP-адресам (иначе `403`).\n\n📄 Документация: https://documentation.mailganer.ru/documentation/task/status"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"{\n \"id\": \"a39929f4-dac8-4f5d-8d02-82c9345234f856\",\n \"state\": \"COMPLETED\",\n \"task_type\": \"DOWNLOAD_MAILING_REPORT\"\n}"},{"id":"5fd31486-9f85-b223-5c31-ba726b73338f","name":"Error — задача не найдена","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://mailganer.com/api/v2/tasks/:task_id","protocol":"https","host":["mailganer","com"],"path":["api","v2","tasks",":task_id"],"variable":[{"id":"262def07-431c-4cff-806c-11aee1e50328","key":"task_id"}]},"description":"Возвращает текущий статус задачи на формирование отчёта по её идентификатору.\n\n**Эндпоинт:** `GET https://mailganer.com/api/v2/tasks/:task_id`\n**Авторизация:** заголовок `Authorization: CodeRequest {{api_key}}` (наследуется от коллекции)\n\n### Параметры пути\n| Поле | Тип | Обяз. | Описание |\n|---|---|---|---|\n| `task_id` | string | Да | UUID задачи, полученный при её создании |\n\n### Пример curl\n```bash\ncurl --location --request GET 'https://mailganer.com/api/v2/tasks/:task_id' \\\n--header 'Authorization: CodeRequest {{api_key}}'\n```\n\n### Примечания\n- Поля ответа: `id` — UUID задачи; `state` — статус; `task_type` — тип отчёта (`DOWNLOAD_SITE_EMAILS`, `DOWNLOAD_SEGMENT`, `DOWNLOAD_MAILING_REPORT` и т.п.).\n- Значения `state`: `IN_PROGRESS` — выполняется; `COMPLETED` — успешно завершена, файл готов к скачиванию; `FAILED` — ошибка формирования.\n- Опрашивайте метод, пока `state` не станет `COMPLETED`, затем скачайте файл через `GET /api/v2/tasks/:task_id/download_file`.\n- Если задача не найдена — ответ с ошибкой `Task by id=... not found`.\n- Для использования метода в аккаунте должно быть включено ограничение доступа к API по IP-адресам (иначе `403`).\n\n📄 Документация: https://documentation.mailganer.ru/documentation/task/status"},"status":"Not Found","code":404,"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"{\n \"status\": \"error\",\n \"error\": \"Task by id=8959d954-9baf-4491-a1b3-46adf787c064 not found\"\n}"}],"_postman_id":"656c767b-5e7d-4abd-896f-e64ac50af4b7"},{"name":"Скачивание готового файла","id":"55e976df-7e00-439b-940d-c4826148d686","request":{"method":"GET","header":[],"url":"https://mailganer.com/api/v2/tasks/:task_id/download_file","description":"

Скачивает готовый файл отчёта по завершённой задаче.

Эндпоинт: GET https://mailganer.com/api/v2/tasks/:task_id/download_file\nАвторизация: заголовок Authorization: CodeRequest {{api_key}} (наследуется от коллекции)

Параметры пути

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Поле	Тип	Обяз.	Описание
`task_id`	string	Да	UUID задачи, полученный при её создании

Пример curl

curl --location --request GET 'https://mailganer.com/api/v2/tasks/:task_id/download_file' \\\n--header 'Authorization: CodeRequest {{api_key}}' \\\n--output report.csv\n

Примечания

Возвращает бинарный файл в формате, указанном при создании задачи (CSV или XLSX).
Скачивание доступно только после того, как задача перешла в статус COMPLETED (проверяйте через GET /api/v2/tasks/:task_id).
Если файл ещё не готов, метод вернёт ошибку {\"status\": \"error\", \"error\": \"Task has not file\"}.
Для использования метода в аккаунте должно быть включено ограничение доступа к API по IP-адресам (иначе 403).
Полный порядок: создать задачу → дождаться статуса COMPLETED → скачать файл этим методом.

📄 Документация: https://documentation.mailganer.ru/documentation/task/download

Передача конверсий (postback). Источник: https://documentation.mailganer.ru/documentation/postback\nХост отдельный (postback.mailganer.com), авторизация не требуется (No Auth). Параметры передаются в query-строке.

Пример curl

curl --location --request GET 'http://postback.mailganer.com/v1/?mailing_id={{public_id}}&sum=1000&currency=RUB&offer=order&email_hash={{email_hash}}&goto_url=domain.com'\n

Обязательный. ID рассылки — используйте переменную {{public_id}}

\n","type":"text/plain"},"key":"mailing_id","value":"{{public_id}}"},{"description":{"content":"

Обязательный. md5-хеш имейла подписчика, выполнившего целевое действие

\n","type":"text/plain"},"key":"email_hash","value":"{{email_hash}}"},{"description":{"content":"

Обязательный. Сумма целевого действия

\n","type":"text/plain"},"key":"sum","value":"1000"},{"description":{"content":"

Необязательный. RUB или USD

\n","type":"text/plain"},"key":"currency","value":"RUB"},{"description":{"content":"

Необязательный. Уточнение, какое целевое действие выполнил подписчик

\n","type":"text/plain"},"key":"offer","value":"order"},{"description":{"content":"

Необязательный. URL для редиректа после обработки

\n","type":"text/plain"},"key":"goto_url","value":"domain.com"}],"variable":[]}},"response":[],"_postman_id":"cfa8d61a-83b5-6c7d-0793-95f9923b7f2e"},{"name":"Обновление переменной по ссылке","id":"10c8c3bb-3981-b28f-b592-43c67f496c18","request":{"method":"GET","header":[],"url":"https://postback.mailganer.com/v1/","description":"

Обновление пользовательской переменной подписчика по клику (postback). Источник: https://documentation.mailganer.ru/documentation/variables_on_click\nТот же хост, что и «Передача конверсий», авторизация не требуется (No Auth). Пользовательскую переменную передавать как get-параметр (имя=значение). goto_url должен содержать протокол и быть urlencode.

Пример curl

curl --location --request GET 'https://postback.mailganer.com/v1/?email_hash={{email_hash}}&mailing_id={{public_id}}&nps=10&goto_url=https%3A%2F%2Fdomain.com%2F%3Futm_source%3Dsource%26clickid%3D{{clickid}}'\n

Обязательный. md5-хеш имейла подписчика, которому нужно обновить переменную

\n","type":"text/plain"},"key":"email_hash","value":"{{email_hash}}"},{"description":{"content":"

Обязательный. ID рассылки — используйте переменную {{public_id}}

\n","type":"text/plain"},"key":"mailing_id","value":"{{public_id}}"},{"description":{"content":"

Пример пользовательской переменной: имя переменной (напр. nps) с её значением

\n","type":"text/plain"},"key":"nps","value":"10"},{"description":{"content":"

Необязательный. URL с протоколом, значение должно быть urlencode

\n","type":"text/plain"},"key":"goto_url","value":"https://domain.com/?utm_source=source&clickid={{clickid}}"}],"variable":[]}},"response":[],"_postman_id":"10c8c3bb-3981-b28f-b592-43c67f496c18"}],"id":"6e0d7e2c-24af-39ce-3321-793d4f96c2e2","_postman_id":"6e0d7e2c-24af-39ce-3321-793d4f96c2e2","description":"","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":""}]},"isInherited":true,"source":{"_postman_id":"ad2a6101-55ec-46be-9158-ec0369852183","id":"ad2a6101-55ec-46be-9158-ec0369852183","name":"REST API Mailganer","type":"collection"}}},{"name":"Вебхуки","item":[{"name":"Изменение статуса подписчика","id":"ec6924b9-df0e-5175-87db-47252d280ed1","request":{"method":"POST","header":[{"key":"Content-Type","value":"application/x-www-form-urlencoded"}],"body":{"mode":"raw","raw":"status=-1&source_name=%D0%A2%D0%B5%D1%81%D1%82+%D1%85%D1%83%D0%BA%D0%B0&source_id=1092359×tamp=2026-05-19+15%3A26%3A19.654599&type=1&method=unsubscribe&email=senkey%40bk.ru"},"url":"{{webhook_url}}","description":"

Событие изменения статуса подписки подписчика (type=1).

Входящий вебхук — Mailganer отправляет POST на ваш URL, заданный методом «Задать ссылку на webhook».

Метод доставки: POST\nContent-Type: application/x-www-form-urlencoded (form-values)

Поля payload

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Поле	Тип	Описание
`type`	int	Тип вебхука, всегда `1` для изменения статуса подписчика
`email`	string	Имейл подписчика
`status`	int	Числовой статус подписки (см. таблицу статусов ниже)
`status_message`	string	Текстовая расшифровка (например, причина недоставки)
`timestamp`	string	Дата и время отправки вебхука
`source_id`	int	ID списка. Передаётся не для всех событий (только при спаме/отписке)
`source_name`	string	Название списка. Передаётся не для всех событий (только при спаме/отписке)
`method`	string	`spam` или `unsubscribe`. Передаётся не для всех событий
`reason`	string	Причина отписки. Передаётся только для событий отписки

Значения `status`

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Значение	Описание
`-6`	Исправлен (при импорте найдены недопустимые символы)
`-5`	Исправлен (опечатка исправлена системой)
`-4`	Помечен как спам сервером
`-3`	Помечен как спам пользователем
`-2`	Недоступен
`-1`	Отписан от рассылок
`0`	Новый
`1`	Активен
`2`	Запрошено подтверждение

Пример payload

status=-1&source_name=%D0%A2%D0%B5%D1%81%D1%82+%D1%85%D1%83%D0%BA%D0%B0&source_id=1092359&timestamp=2026-05-19+15%3A26%3A19.654599&type=1&method=unsubscribe&email=senkey%40bk.ru\n

Примечания

Хук активируется в настройках списка на вкладке «Интеграции».
Опциональный переключатель добавляет в запрос заголовок с ключом авторизации.
Поля source_id, source_name, method передаются не для всех событий — только когда пользователь пожаловался на спам или отписался. Поле reason присутствует только для отписки.
Повторные попытки при ошибке на вашем эндпоинте: через 5 секунд, 1 час и 24 часа.

📄 Документация: https://documentation.mailganer.ru/documentation/webhooks/email_status

Событие взаимодействия с письмом в массовой или триггерной рассылке (type=3). Срабатывает на каждое сообщение при любом взаимодействии с ним.

Входящий вебхук — Mailganer отправляет POST на ваш URL, заданный методом «Задать ссылку на webhook».

Метод доставки: POST\nContent-Type: application/x-www-form-urlencoded (form-values)

Поля payload

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Поле	Тип	Описание
`type`	int	Тип вебхука, всегда `3` для взаимодействия с письмом
`email`	string	Имейл получателя
`source`	int	ID списка, которому принадлежит письмо
`action`	int	Тип взаимодействия (см. таблицу значений ниже)
`timestamp`	string	Дата и время взаимодействия
`mail_type`	string	`mailing` (массовая рассылка) или `trigger` (триггерное сообщение)
`public_id`	string	Публичный ID массовой/триггерной рассылки
`mail_id`	string	ID отправки сообщения (для триггерных рассылок)
`trigger_id`	string	ID триггера в системе Mailganer

Значения `action`

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Значение	Описание
`-3`	Не доставлено
`-2`	Жалоба на спам
`-1`	Отписка
`1`	Доставлено
`2`	Открытие письма
`3`	Клик по ссылке в письме

Значения `mail_type`

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Значение	Описание
`mailing`	Взаимодействие из вручную отправленной массовой рассылки
`trigger`	Взаимодействие из триггерного сообщения

Пример payload

mail_id=999129235&public_id=166118134802&mail_type=mailing&action=1&timestamp=2022-08-22+15%3A18%3A44.960548&type=3&email=example%40mail.ru\n

Примечания

Хук активируется в настройках списка на вкладке «Интеграции».
Опциональный переключатель добавляет в запрос заголовок с ключом авторизации.
Повторные попытки при ошибке на вашем эндпоинте: через 5 секунд, 1 час и 24 часа.

📄 Документация: https://documentation.mailganer.ru/documentation/webhooks/mail_status

Событие изменения данных в карточке подписчика (type=2). Хук отправляется каждый раз, когда изменяется какое-либо поле в карточке подписчика.

Входящий вебхук — Mailganer отправляет POST на ваш URL, заданный методом «Задать ссылку на webhook».

Метод доставки: POST\nContent-Type: application/x-www-form-urlencoded (form-values)

Поля payload

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Поле	Тип	Описание
`type`	int	Тип вебхука, всегда `2` для изменения данных о подписчике
`src`	int	Источник изменения: `1` — изменение через API, `2` — изменение через интерфейс
`email`	string	Имейл подписчика
`birthday`	date	Дата рождения, формат `YYYY-MM-DD`
`user_vars`	array	Пользовательские переменные в формате `[['variable_name', 'value'], ['variable_name2', 'value']]`

Пример payload

type=2&src=2&email=example%40mail.ru&birthday=1988-01-01\n

Примечания

В документации нет готового примера payload; тело выше собрано из перечня документированных полей с иллюстративными значениями-заглушками.
Хук активируется в настройках списка на вкладке «Интеграции».
Опциональный переключатель добавляет в запрос заголовок с ключом авторизации.
Хук срабатывает только при фактическом изменении данных.
Пользовательские переменные (user_vars) передаются парами «имя — значение» в виде массива.
Повторные попытки при ошибке на вашем эндпоинте: через 5 секунд, 1 час и 24 часа.

📄 Документация: https://documentation.mailganer.ru/documentation/webhooks/email_meta

Событие срабатывания триггера (type=4). Используется, когда нужно передать информацию во внешнюю систему вместе с отправкой письма или передать данные без отправки письма.

Входящий вебхук — Mailganer отправляет POST на ваш URL, заданный методом «Задать ссылку на webhook».

Метод доставки: POST\nContent-Type: application/x-www-form-urlencoded (form-values)

Поля payload

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Поле	Тип	Описание
`type`	int	Тип вебхука, всегда `4` для срабатывания события в триггере
`public_id`	int	ID триггера
`email`	string	Имейл подписчика
`phone`	string	Телефон
`name`	string	Имя
`surname`	string	Фамилия
`patronymic`	string	Отчество
`gender`	int	Пол: `1` — мужской, `2` — женский
`birthday`	date	Дата рождения, формат `dd.mm.yyyy`
`city`	string	Город
`user_var_{имя_переменной}`	string	Пользовательские переменные передаются как `user_var_{имя_переменной}` (например, `user_var_company_name`)

Пример payload

type=4&public_id=166118134802&email=example%40mail.ru&phone=%2B79123456789&name=%D0%A4%D0%B5%D0%B4%D0%BE%D1%80&surname=%D0%A4%D0%B5%D0%B4%D0%BE%D1%80%D0%BE%D0%B2&patronymic=%D0%A4%D0%B5%D0%B4%D0%BE%D1%80%D0%BE%D0%B2%D0%B8%D1%87&gender=1&birthday=01.01.1988&city=%D0%9C%D0%BE%D1%81%D0%BA%D0%B2%D0%B0&user_var_company_name=Ganer\n

Примечания

В документации нет готового примера payload; тело выше собрано из перечня документированных полей с иллюстративными значениями-заглушками.
Хук активируется в настройках списка на вкладке «Интеграции».
Опциональный переключатель добавляет в запрос заголовок с ключом авторизации.
Пользовательские переменные передаются с префиксом user_var_ в названии поля.
Повторные попытки при ошибке на вашем эндпоинте: через 5 секунд, 1 час и 24 часа.

📄 Документация: https://documentation.mailganer.ru/documentation/webhooks/trigger_event