# Unisender API: Отправить одиночное письмо

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

Письмо одному адресату: подтверждение регистрации, уведомление о заказе.

1. Отправь: POST /ru/api/sendEmail с email, sender_name, sender_email, subject, body и list_id — списком, от которого адресат сможет отписаться.
2. Новым аккаунтам по умолчанию доступно до 1000 таких писем в сутки; одному адресату — не чаще раза в 60 секунд; размер письма — до 1 МБ.
3. Статус доставки проверяется методом checkEmail и хранится месяц.
4. Для большого потока транзакционных писем документация рекомендует отдельный сервис Unisender Go.

```bash
curl -X POST "https://api.unisender.com/ru/api/sendEmail?format=json" \
  -d api_key=<ключ> \
  --data-urlencode 'email=Иван Петров <ivan@example.ru>' \
  --data-urlencode 'sender_name=Магазин' -d sender_email=noreply@example.ru \
  --data-urlencode 'subject=Заказ №1042 оформлен' \
  --data-urlencode 'body=<p>Спасибо за заказ! Мы сообщим, когда он будет отправлен.</p>' \
  -d list_id=<код списка>
```

## Базовые 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/sendEmail — Отправка одиночного письма

По умолчанию новым пользователям — до 1000 писем в сутки; письмо до 1 МБ; одному адресату — не чаще раза в 60 секунд. Статус доставки — методом `checkEmail` (хранится месяц).

| Параметр | Где | Тип | Обяз. | Описание |
|---|---|---|---|---|
| `api_key` | body | string | да | Ключ доступа |
| `email` | body | string | да | Получатель (можно с именем перед адресом) |
| `sender_name` | body | string | да | Имя отправителя |
| `sender_email` | body | string | да | Подтверждённый email отправителя |
| `subject` | body | string | да | Тема |
| `body` | body | string | да | HTML-текст |
| `list_id` | body | integer | да | Список, от которого адресат сможет отписаться |
| `attachments` | body | array | нет | Вложения attachments[filename] |
| `lang` | body | string | нет | Язык |
| `track_read` | body | integer | нет | Отслеживать прочтения |
| `track_links` | body | integer | нет | Отслеживать переходы |
| `cc` | body | string | нет | Копия |
| `headers` | body | string | нет | Дополнительные заголовки |
| `error_checking` | body | integer | нет | Режим проверки ошибок |
| `metadata` | body | object | нет | Метаданные metadata[key]=value |

## Нюансы

- Параметры можно передавать 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://mcp-everything.ru/integrations/unisender/scenarios/zagruzit-bazu-kontaktov.md)
- [Запустить email-рассылку по списку](https://mcp-everything.ru/integrations/unisender/scenarios/zapustit-email-rassylku-po-spisku.md)

---

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