# Sendsay API: POST /general/api/v100/json/{account} — issue.send: массовая рассылка

Переменные в тексте вида `[% anketa.personal.product %]` должны совпадать с ключами в запросе.

| Параметр | Где | Тип | Обяз. | Описание |
|---|---|---|---|---|
| `account` | path | string | да | Код аккаунта |
| `action` | body | string | да | issue.send |
| `name` | body | string | нет | Название черновика |
| `sendwhen` | body | string | да | now |
| `group` | body | string | да | masssending |
| `letter` | body | object | да | draft.id существующего черновика либо тема, отправитель и HTML |
| `users.list` | body | object | нет | Получатели: массив с блоками member и personal или объект caption + rows |

## Базовые URL

- Боевой: `https://api.sendsay.ru`
- Адрес вызова: `https://api.sendsay.ru/general/api/v100/json/{account}`

## Авторизация

Тип: API-ключ

Рекомендуемый способ — API-ключ (создаётся вызовом `sys.user.apikey.create`, лучше на отдельный саблогин с минимальными правами). Ключ передаётся полем `apikey` в теле JSON или заголовком `Authorization: sendsay apikey=...` (ключ URL-кодируется). Аутентификация действует на один вызов, выход не нужен. Также поддерживаются логин с паролем (сессия), JWT, двухфакторная аутентификация и OpenID.

## Нюансы

- Тело — JSON в UTF-8 с `Content-Type: application/json`; обязательное поле — `action`; размер запроса — до 400 МБ.
- Ответы с кодами 3xx — перенаправления, клиент обязан их обрабатывать.
- Массив `warnings` означает частичное выполнение, а не ошибку.
- При `error/auth/failed` с уточнением `force_change_password` смените пароль через `sys.user.set` и повторите запрос.
- Результаты импорта и других заданий видны в журнале заданий (`https://app.sendsay.ru/queue`).
- Есть также вызовы стоп-листов, черновиков, форм, участников сценариев и Stream API.

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

- [Отправить транзакционное письмо](https://mcp-everything.ru/integrations/sendsay/scenarios/otpravit-tranzaktsionnoe-pismo.md)
- [Запустить массовую рассылку](https://mcp-everything.ru/integrations/sendsay/scenarios/zapustit-massovuyu-rassylku.md)

---

Если этого недостаточно — официальная документация: https://docs.sendsay.ru/sendsay-api/sendsay-api-guide
Вся интеграция одним документом: https://mcp-everything.ru/integrations/sendsay.md