Unisender API: Загрузить базу контактов

Сценарий из mcp-everything. Актуально на 2026-10-24.

Перенести контакты из CRM или старого сервиса пачками.

1. Подготовь данные: field_names — названия столбцов (обязательно email, можно email_list_ids для списков и свои поля), data — строки со значениями в том же порядке.
2. Загружай пачками: POST /ru/api/importContacts — не больше 500 контактов за вызов.
3. Таймаут вызова — 30 секунд. Если ответа нет, повтори не больше двух раз — повтор безопасен, контакты обновятся, а не задвоятся.
4. Флаги overwrite_tags и overwrite_lists определяют, заменять ли метки и списки существующих контактов или добавлять к ним.

curl -X POST "https://api.unisender.com/ru/api/importContacts?format=json" \
  -d api_key=<ключ> \
  --data-urlencode 'field_names[0]=email' \
  --data-urlencode 'field_names[1]=Name' \
  --data-urlencode 'field_names[2]=email_list_ids' \
  --data-urlencode 'data[0][0]=ivan@example.ru' --data-urlencode 'data[0][1]=Иван' -d 'data[0][2]=<код списка>' \
  --data-urlencode 'data[1][0]=anna@example.ru' --data-urlencode 'data[1][1]=Анна' -d 'data[1][2]=<код списка>'

Базовые URL

• Боевой: https://api.unisender.com
• Формат вызова: https://api.unisender.com/LANG/api/METHOD?format=json&api_key=KEY&arg1=ARG_1

Авторизация

Тип: API-ключ

API-ключ копируется в личном кабинете и передаётся параметром api_key. Рекомендуется передавать его через POST, чтобы ключ не попадал в логи прокси. Доступ можно дополнительно ограничить списком доверенных IP.

https://api.unisender.com/ru/api/getLists?format=json&api_key=KEY

Методы сценария

POST /ru/api/importContacts — Массовый импорт контактов

Таймаут вызова — 30 секунд; при отсутствии ответа — до двух повторов.

Параметр	Где	Тип	Обяз.	Описание
api_key	body	string	да	Ключ доступа
field_names	body	array	да	Названия столбцов; обязательно поле email, до 50 пользовательских полей
data	body	array	да	Данные контактов, не больше 500 за вызов
overwrite_tags	body	boolean	нет	Перезаписывать метки
overwrite_lists	body	boolean	нет	Перезаписывать списки

Нюансы

• Параметры можно передавать GET или POST, кодировка UTF-8; запросы и ответы можно сжимать gzip или bzip2.
• Успешный ответ — поле result без error; могут быть warnings[] с полем warning.
• Типичная цепочка рассылки: getLists → createEmailMessage → createCampaign → getCampaignStatus.
• Также есть методы SMS (createSmsMessage, sendSms, checkSms), шаблонов, полей и меток, заметок, статистики (getCampaignCommonStats, getVisitedLinks) и Event tracking API.

Другие сценарии

• Подписать контакт на рассылку с сайта
• Запустить email-рассылку по списку
• Отправить одиночное письмо

---

Если этого недостаточно — официальная документация: https://www.unisender.com/ru/support/api/common/bulk-email/ Вся интеграция одним документом: https://mcp-everything.ru/integrations/unisender.md