{"name":"Unisender API","vendor":"Unisender","industry":"communications","summary":"API сервиса email- и SMS-рассылок Unisender: списки контактов, подписка и импорт контактов, создание email- и SMS-сообщений, запуск и статус рассылок, одиночные письма, шаблоны, дополнительные поля и метки, статистика. Использовать API можно бесплатно на любом аккаунте. Для транзакционных писем без ограничений документация рекомендует отдельный сервис Unisender Go.","docsUrl":"https://www.unisender.com/ru/support/api/common/bulk-email/","coverage":{"included":[],"excluded":[]},"scenarios":[{"id":"podpisat-kontakt-na-rassylku-s-sayta","title":"Подписать контакт на рассылку с сайта","summary":"Форма подписки на сайте добавляет email в список Unisender.","steps":["Скопируй API-ключ в личном кабинете. Передавай его параметром api_key методом POST, чтобы ключ не попадал в логи прокси. Формат вызова: https://api.unisender.com/ru/api/<метод>?format=json.","Узнай код списка: POST /ru/api/getLists — в result список с id и title.","Подпиши контакт: POST /ru/api/subscribe с list_ids, fields[email] (и при необходимости fields[phone], fields[Name]) и tags. double_optin = 0 отправит письмо-приглашение с подтверждением, 3 — добавит контакт без письма (только если согласие уже получено на твоей стороне).","Успешный ответ — поле result без error; предупреждения приходят в warnings."],"code":"curl -X POST \"https://api.unisender.com/ru/api/subscribe?format=json\" \\\n  -d api_key=<ключ> \\\n  -d list_ids=<код списка> \\\n  --data-urlencode 'fields[email]=ivan@example.ru' \\\n  --data-urlencode 'fields[Name]=Иван' \\\n  --data-urlencode 'tags=сайт,подписка' \\\n  -d double_optin=0","language":"bash","methods":["POST /ru/api/getLists","POST /ru/api/subscribe"]},{"id":"zagruzit-bazu-kontaktov","title":"Загрузить базу контактов","summary":"Перенести контакты из CRM или старого сервиса пачками.","steps":["Подготовь данные: field_names — названия столбцов (обязательно email, можно email_list_ids для списков и свои поля), data — строки со значениями в том же порядке.","Загружай пачками: POST /ru/api/importContacts — не больше 500 контактов за вызов.","Таймаут вызова — 30 секунд. Если ответа нет, повтори не больше двух раз — повтор безопасен, контакты обновятся, а не задвоятся.","Флаги overwrite_tags и overwrite_lists определяют, заменять ли метки и списки существующих контактов или добавлять к ним."],"code":"curl -X POST \"https://api.unisender.com/ru/api/importContacts?format=json\" \\\n  -d api_key=<ключ> \\\n  --data-urlencode 'field_names[0]=email' \\\n  --data-urlencode 'field_names[1]=Name' \\\n  --data-urlencode 'field_names[2]=email_list_ids' \\\n  --data-urlencode 'data[0][0]=ivan@example.ru' --data-urlencode 'data[0][1]=Иван' -d 'data[0][2]=<код списка>' \\\n  --data-urlencode 'data[1][0]=anna@example.ru' --data-urlencode 'data[1][1]=Анна' -d 'data[1][2]=<код списка>'","language":"bash","methods":["POST /ru/api/importContacts"]},{"id":"zapustit-email-rassylku-po-spisku","title":"Запустить email-рассылку по списку","summary":"Создать письмо, отправить его по списку и узнать результат.","steps":["Создай письмо: POST /ru/api/createEmailMessage с sender_name, sender_email (подтверждённый адрес), subject, body (HTML) и list_id. Письмо отправляется только по одному списку. В ответе — код сообщения.","Запусти рассылку: POST /ru/api/createCampaign с message_id. Без start_time отправка начнётся сразу; для отложенной передай start_time (не дальше 100 дней) и timezone. Включи track_read и track_links, чтобы видеть открытия и переходы.","Проверяй статус: POST /ru/api/getCampaignStatus с campaign_id. Перед отправкой рассылка может пройти модерацию (waits_censor), итог — completed. Время в ответе — UTC."],"code":"MSG=$(curl -s -X POST \"https://api.unisender.com/ru/api/createEmailMessage?format=json\" \\\n  -d api_key=<ключ> --data-urlencode 'sender_name=Магазин' -d sender_email=news@example.ru \\\n  --data-urlencode 'subject=Скидки выходного дня' --data-urlencode 'body=<h1>Скидка 20%</h1><p>Только до воскресенья.</p>' \\\n  -d list_id=<код списка> | jq -r .result.message_id)\n\ncurl -X POST \"https://api.unisender.com/ru/api/createCampaign?format=json\" \\\n  -d api_key=<ключ> -d message_id=$MSG -d track_read=1 -d track_links=1","language":"bash","methods":["POST /ru/api/createEmailMessage","POST /ru/api/createCampaign","POST /ru/api/getCampaignStatus"]},{"id":"otpravit-odinochnoe-pismo","title":"Отправить одиночное письмо","summary":"Письмо одному адресату: подтверждение регистрации, уведомление о заказе.","steps":["Отправь: POST /ru/api/sendEmail с email, sender_name, sender_email, subject, body и list_id — списком, от которого адресат сможет отписаться.","Новым аккаунтам по умолчанию доступно до 1000 таких писем в сутки; одному адресату — не чаще раза в 60 секунд; размер письма — до 1 МБ.","Статус доставки проверяется методом checkEmail и хранится месяц.","Для большого потока транзакционных писем документация рекомендует отдельный сервис Unisender Go."],"code":"curl -X POST \"https://api.unisender.com/ru/api/sendEmail?format=json\" \\\n  -d api_key=<ключ> \\\n  --data-urlencode 'email=Иван Петров <ivan@example.ru>' \\\n  --data-urlencode 'sender_name=Магазин' -d sender_email=noreply@example.ru \\\n  --data-urlencode 'subject=Заказ №1042 оформлен' \\\n  --data-urlencode 'body=<p>Спасибо за заказ! Мы сообщим, когда он будет отправлен.</p>' \\\n  -d list_id=<код списка>","language":"bash","methods":["POST /ru/api/sendEmail"]}],"baseUrls":[{"label":"Боевой","url":"https://api.unisender.com"},{"label":"Формат вызова","url":"https://api.unisender.com/LANG/api/METHOD?format=json&api_key=KEY&arg1=ARG_1"}],"auth":{"type":"api_key","description":"API-ключ копируется в личном кабинете и передаётся параметром `api_key`. Рекомендуется передавать его через POST, чтобы ключ не попадал в логи прокси. Доступ можно дополнительно ограничить списком доверенных IP.","example":"https://api.unisender.com/ru/api/getLists?format=json&api_key=KEY"},"methods":[{"id":"POST /ru/api/getLists","title":"Списки рассылки","httpMethod":"POST","path":"/ru/api/getLists","description":"В ответе `result[]`: `id`, `title`.","params":[{"name":"api_key","in":"body","type":"string","required":true,"description":"Ключ доступа"},{"name":"format","in":"query","type":"string","required":true,"description":"json"}],"requestExample":"","responseExample":"","docsUrl":""},{"id":"POST /ru/api/subscribe","title":"Подписка контакта","httpMethod":"POST","path":"/ru/api/subscribe","description":"","params":[{"name":"api_key","in":"body","type":"string","required":true,"description":"Ключ доступа"},{"name":"list_ids","in":"body","type":"string","required":true,"description":"Коды списков через запятую (из getLists)"},{"name":"fields[email]","in":"body","type":"string","required":true,"description":"Email контакта"},{"name":"fields[phone]","in":"body","type":"string","required":false,"description":"Телефон в международном формате, например +79261232323"},{"name":"tags","in":"body","type":"string","required":false,"description":"Метки через запятую, не больше 10"},{"name":"double_optin","in":"body","type":"integer","required":false,"description":"0 — отправить письмо-приглашение, 3 — добавить без письма"},{"name":"overwrite","in":"body","type":"integer","required":false,"description":"Режим перезаписи полей и меток"}],"requestExample":"","responseExample":"","docsUrl":""},{"id":"POST /ru/api/importContacts","title":"Массовый импорт контактов","httpMethod":"POST","path":"/ru/api/importContacts","description":"Таймаут вызова — 30 секунд; при отсутствии ответа — до двух повторов.","params":[{"name":"api_key","in":"body","type":"string","required":true,"description":"Ключ доступа"},{"name":"field_names","in":"body","type":"array","required":true,"description":"Названия столбцов; обязательно поле email, до 50 пользовательских полей"},{"name":"data","in":"body","type":"array","required":true,"description":"Данные контактов, не больше 500 за вызов"},{"name":"overwrite_tags","in":"body","type":"boolean","required":false,"description":"Перезаписывать метки"},{"name":"overwrite_lists","in":"body","type":"boolean","required":false,"description":"Перезаписывать списки"}],"requestExample":"","responseExample":"","docsUrl":""},{"id":"POST /ru/api/createEmailMessage","title":"Создание email-сообщения","httpMethod":"POST","path":"/ru/api/createEmailMessage","description":"Возвращает код сообщения для `createCampaign`. Письмо отправляется только по одному списку.","params":[{"name":"api_key","in":"body","type":"string","required":true,"description":"Ключ доступа"},{"name":"sender_name","in":"body","type":"string","required":true,"description":"Имя отправителя (не email)"},{"name":"sender_email","in":"body","type":"string","required":true,"description":"Подтверждённый email отправителя"},{"name":"subject","in":"body","type":"string","required":false,"description":"Тема; обязательна, если нет template_id"},{"name":"body","in":"body","type":"string","required":false,"description":"HTML-текст; обязателен, если нет template_id/system_template_id"},{"name":"list_id","in":"body","type":"integer","required":true,"description":"Код списка"},{"name":"text_body","in":"body","type":"string","required":false,"description":"Текстовая версия"},{"name":"generate_text","in":"body","type":"integer","required":false,"description":"1 — сгенерировать текстовую часть из HTML (по умолчанию 0)"},{"name":"tag","in":"body","type":"string","required":false,"description":"Отправить только контактам с меткой"},{"name":"attachments","in":"body","type":"array","required":false,"description":"Вложения"},{"name":"lang","in":"body","type":"string","required":false,"description":"Язык"},{"name":"template_id","in":"body","type":"integer","required":false,"description":"Шаблон вместо subject и body"},{"name":"wrap_type","in":"body","type":"string","required":false,"description":"Тип обёртки письма"},{"name":"categories","in":"body","type":"string","required":false,"description":"Категории"}],"requestExample":"","responseExample":"","docsUrl":""},{"id":"POST /ru/api/createCampaign","title":"Запуск рассылки","httpMethod":"POST","path":"/ru/api/createCampaign","description":"Запускает сразу или по расписанию ранее созданное email- или SMS-сообщение; возвращает код рассылки.","params":[{"name":"api_key","in":"body","type":"string","required":true,"description":"Ключ доступа"},{"name":"message_id","in":"body","type":"integer","required":true,"description":"Код сообщения из createEmailMessage/createSmsMessage"},{"name":"start_time","in":"body","type":"string","required":false,"description":"ГГГГ-ММ-ДД чч:мм, не дальше 100 дней; без него — сразу"},{"name":"timezone","in":"body","type":"string","required":false,"description":"Часовой пояс start_time; явно поддерживается UTC"},{"name":"track_read","in":"body","type":"integer","required":false,"description":"1 — отслеживать прочтения (по умолчанию 0)"},{"name":"track_links","in":"body","type":"integer","required":false,"description":"1 — отслеживать переходы (по умолчанию 0)"},{"name":"contacts","in":"body","type":"string","required":false,"description":"Email или телефоны через запятую; без него — весь список"},{"name":"contacts_url","in":"body","type":"string","required":false,"description":"URL файла со списком контактов (нельзя вместе с contacts)"},{"name":"track_ga","in":"body","type":"integer","required":false,"description":"Добавлять UTM-метки (ga_medium, ga_source, ga_campaign, ga_content, ga_term)"}],"requestExample":"","responseExample":"","docsUrl":""},{"id":"POST /ru/api/getCampaignStatus","title":"Статус рассылки","httpMethod":"POST","path":"/ru/api/getCampaignStatus","description":"Время в ответе — UTC.\n\nСтатусы: `waits_censor`, `censor_hold`, `declined`, `waits_schedule`, `scheduled`, `in_progress`, `analysed`, `completed`, `stopped`, `canceled`.","params":[{"name":"api_key","in":"body","type":"string","required":true,"description":"Ключ доступа"},{"name":"campaign_id","in":"body","type":"integer","required":true,"description":"Код рассылки из createCampaign"}],"requestExample":"","responseExample":"{ \"result\":{ \"status\":\"completed\", \"creation_time\":\"2011-09-21 19:47:31\", \"start_time\":\"2011-09-21 20:00:00\" } }","docsUrl":""},{"id":"POST /ru/api/sendEmail","title":"Отправка одиночного письма","httpMethod":"POST","path":"/ru/api/sendEmail","description":"По умолчанию новым пользователям — до 1000 писем в сутки; письмо до 1 МБ; одному адресату — не чаще раза в 60 секунд. Статус доставки — методом `checkEmail` (хранится месяц).","params":[{"name":"api_key","in":"body","type":"string","required":true,"description":"Ключ доступа"},{"name":"email","in":"body","type":"string","required":true,"description":"Получатель (можно с именем перед адресом)"},{"name":"sender_name","in":"body","type":"string","required":true,"description":"Имя отправителя"},{"name":"sender_email","in":"body","type":"string","required":true,"description":"Подтверждённый email отправителя"},{"name":"subject","in":"body","type":"string","required":true,"description":"Тема"},{"name":"body","in":"body","type":"string","required":true,"description":"HTML-текст"},{"name":"list_id","in":"body","type":"integer","required":true,"description":"Список, от которого адресат сможет отписаться"},{"name":"attachments","in":"body","type":"array","required":false,"description":"Вложения attachments[filename]"},{"name":"lang","in":"body","type":"string","required":false,"description":"Язык"},{"name":"track_read","in":"body","type":"integer","required":false,"description":"Отслеживать прочтения"},{"name":"track_links","in":"body","type":"integer","required":false,"description":"Отслеживать переходы"},{"name":"cc","in":"body","type":"string","required":false,"description":"Копия"},{"name":"headers","in":"body","type":"string","required":false,"description":"Дополнительные заголовки"},{"name":"error_checking","in":"body","type":"integer","required":false,"description":"Режим проверки ошибок"},{"name":"metadata","in":"body","type":"object","required":false,"description":"Метаданные metadata[key]=value"}],"requestExample":"","responseExample":"","docsUrl":""}],"codeExamples":[],"errors":[],"limits":"Счётчик ведётся отдельно для каждого API-ключа или IP.","gotchas":["Параметры можно передавать GET или POST, кодировка UTF-8; запросы и ответы можно сжимать gzip или bzip2.","Успешный ответ — поле `result` без `error`; могут быть `warnings[]` с полем `warning`.","Типичная цепочка рассылки: `getLists` → `createEmailMessage` → `createCampaign` → `getCampaignStatus`.","Также есть методы SMS (`createSmsMessage`, `sendSms`, `checkSms`), шаблонов, полей и меток, заметок, статистики (`getCampaignCommonStats`, `getVisitedLinks`) и Event tracking API."],"slug":"unisender","version":2,"updatedAt":"2026-10-24T17:05:38.280Z","sources":[{"title":"Формат запросов API","url":"https://www.unisender.com/ru/support/api/common/bulk-email/","kind":"research","addedAt":"2026-10-17T07:37:45.964Z"},{"title":"Лимиты по запросам","url":"https://www.unisender.com/ru/support/api/common/api-limits/","kind":"research","addedAt":"2026-10-17T07:37:45.964Z"},{"title":"getLists","url":"https://www.unisender.com/ru/support/api/contacts/getlists/","kind":"research","addedAt":"2026-10-17T07:37:45.964Z"},{"title":"subscribe","url":"https://www.unisender.com/ru/support/api/contacts/subscribe/","kind":"research","addedAt":"2026-10-17T07:37:45.964Z"},{"title":"importContacts","url":"https://www.unisender.com/ru/support/api/contacts/importcontacts/","kind":"research","addedAt":"2026-10-17T07:37:45.964Z"},{"title":"createEmailMessage","url":"https://www.unisender.com/ru/support/api/messages/createemailmessage/","kind":"research","addedAt":"2026-10-17T07:37:45.964Z"},{"title":"createCampaign","url":"https://www.unisender.com/ru/support/api/messages/createcampaign/","kind":"research","addedAt":"2026-10-17T07:37:45.964Z"},{"title":"getCampaignStatus","url":"https://www.unisender.com/ru/support/api/statistics/getcampaignstatus/","kind":"research","addedAt":"2026-10-17T07:37:45.964Z"},{"title":"sendEmail","url":"https://www.unisender.com/ru/support/api/messages/sendemail/","kind":"research","addedAt":"2026-10-17T07:37:45.964Z"},{"title":"Вставленный текст","url":"","kind":"import","addedAt":"2026-10-17T07:37:45.964Z"},{"title":"scenarios-unisender.md","url":"","kind":"import","addedAt":"2026-10-24T17:05:28.150Z"}],"logoUrl":null}