DashaMail REST API v2: POST /v2/transactional/messages — Транзакционное письмо

Доставка асинхронная; ответ 201 с response.data.transaction_id.

Параметр	Где	Тип	Обяз.	Описание
`to`	body	string	да	Получатель; несколько — через запятую (каждому отдельное письмо)
`from_email`	body	string	да	Отправитель (можно заменить заголовком From в headers)
`message`	body	string	нет	HTML; нужен он или plain_text
`plain_text`	body	string	нет	Текстовая версия
`from_name`	body	string	нет	Имя отправителя
`subject`	body	string	нет	Тема
`message_id`	body	string	нет	Свой ID письма
`cc`	body	string	нет	Копия
`bcc`	body	string	нет	Скрытая копия
`headers`	body	string	нет	Заголовки (JSON-строка)
`attachments`	body	string	нет	Вложения в base64 (JSON-строка); .php, .exe запрещены
`inline`	body	string	нет	Встраиваемые изображения (JPEG, PNG, GIF), ссылка cid:
`delivery_time`	body	integer	нет	Отложенная отправка, timestamp

Пример запроса:

curl -X POST 'https://api.dashamail.com/v2/transactional/messages' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"to": "ivan@example.com", "from_email": "noreply@example.ru", "subject": "Заказ №1024 оплачен", "message": "<p>...</p>", "message_id": "order-1024-paid"}'

Базовые URL

Боевой: https://api.dashamail.com
Ресурсы: /v2

Авторизация

Тип: Bearer-токен

API-ключ из личного кабинета передаётся в заголовке Authorization: Bearer <ключ> (схема ApiKey тоже принимается). Для совместимости ключ можно передать параметром api_key в строке запроса — менее безопасно; при заданном заголовке параметр игнорируется.

curl 'https://api.dashamail.com/v2/lists' \
  -H 'Authorization: Bearer YOUR_API_KEY'

Нюансы

Перед запуском рассылки проверяются тема, отправитель, наличие HTML или текста, ссылка отписки (id="unsub_link" в HTML или %ОТПИСАТЬСЯ% в тексте) и баланс.
Домен from_email должен быть добавлен и подтверждён (DKIM, SPF), иначе письма не уйдут (код 34).
Ответы — JSON с response.data; журнал и статистика транзакционных писем — GET /v2/transactional/log и GET /v2/transactional/stats.
Разделы API: /lists, /campaigns, /automations, /templates, /reports, /transactional, /account, /router.

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

Отправить транзакционное письмо

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