DashaMail REST API v2: GET /v2/lists — Адресные базы

В response.data — базы с полями id, state, name, merge_1…merge_N и счётчиками count_active, count_unsubscribed, count_all и др.

Параметр	Где	Тип	Обяз.	Описание
state	query	string	нет	active, archived, blocked
limit	query	integer	нет	Число баз; без него — все
offset	query	integer	нет	Смещение (только с limit)
merge_json	query	boolean	нет	Описания доп. полей в JSON

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