# Unisender API: POST /ru/api/getLists — Списки рассылки

В ответе `result[]`: `id`, `title`.

| Параметр | Где | Тип | Обяз. | Описание |
|---|---|---|---|---|
| `api_key` | body | string | да | Ключ доступа |
| `format` | query | string | да | json |

## Базовые 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
```

## Нюансы

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

## Сценарии с этим методом

- [Подписать контакт на рассылку с сайта](https://mcp-everything.ru/integrations/unisender/scenarios/podpisat-kontakt-na-rassylku-s-sayta.md)

---

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