Sendsay API: Узнать, кому дошли письма

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

Статистика доставки по рассылке или по конкретному адресу.

Вызови action = stat.uni с select — нужными полями, например deliv.member.email и deliv.result.
Условия задай в filter: a — поле, op — оператор, v — значение. Для периода используй поля дат.
Большую выгрузку можно сохранить файлом: result с типом save и форматом xlsx.

curl -L -X POST "https://api.sendsay.ru/general/api/v100/json/<аккаунт>" \
  -H 'Content-Type: application/json' \
  -d '{
        "action": "stat.uni",
        "apikey": "<API-ключ>",
        "select": ["deliv.member.email", "deliv.result"],
        "filter": [{"a": "deliv.member.email", "op": "==", "v": "ivan@example.ru"}]
      }'

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

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

POST /general/api/v100/json/{account} — stat.uni: универсальная статистика

Параметр	Где	Тип	Обяз.	Описание
`account`	path	string	да	Код аккаунта
`action`	body	string	да	stat.uni
`select`	body	array	да	Поля, например deliv.member.email, deliv.result
`filter`	body	array	нет	Условия a (поле), op (оператор), v (значение); для периода — суффикс :YD
`groupby`	body	array	нет	Группировка
`join`	body	object	нет	Объединение выборок
`result`	body	object	нет	Выгрузка в файл, например тип save, формат xlsx

Нюансы

Тело — 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