Sendsay API: POST /general/api/v100/json/{account} — issue.send: транзакционное письмо

В ответе — letter, по нему письмо отслеживается в статистике.

Параметр	Где	Тип	Обяз.	Описание
`account`	path	string	да	Код аккаунта
`action`	body	string	да	issue.send
`sendwhen`	body	string	да	now — отправить сразу
`group`	body	string	да	personal
`email`	body	string	да	Получатель
`letter.subject`	body	string	да	Тема
`letter.from.name`	body	string	нет	Имя отправителя
`letter.from.email`	body	string	да	Адрес отправителя
`letter.message.html`	body	string	да	HTML-текст
`extra`	body	object	нет	Значения для подстановки в шаблон
`relink`	body	integer	нет	Перелинковка ссылок

Базовые 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://docs.sendsay.ru/sendsay-api/sendsay-api-guide Вся интеграция одним документом: https://mcp-everything.ru/integrations/sendsay.md