DashaMail
DashaMail is an email marketing service used by Russian businesses.
От сообщества: Добавлен пользователем или импортирован; проверьте владельца перед подключениемРаботаетБез входаRU / СНГБесплатноМожет изменять данные
Что умеет
- Account Get: Текущие лимиты аккаунта и число активных подписчиков. Самый дешёвый запрос — годится для проверки работоспособности ключа. limit_members — максимум активных подписчиков по тарифу (0 — лим
- Senders List: Список адресов, подтверждённых как обратные. Возвращается массивом строк, не более ста записей. В from_email рассылки можно ставить только адрес из этого списка. The list of addresses ve
- Senders Add: Отправляет на указанный адрес письмо со ссылкой подтверждения. Адрес станет доступен как обратный после того, как получатель перейдёт по ссылке. На адрес уходит письмо со ссылкой; отправи
Какие данные видит
Нужен ли аккаунт
Не нужен: сервер работает без входа
DashaMail is an email marketing service used by Russian businesses. The MCP server exposes an account through 75 tools: subscriber lists and members, campaigns (draft, edit, schedule, send, pause, resend), reports (funnel, domains, links, geography, devices, bounces), templates, automations, transactional email, webhooks and inbound routing.
Draft-first by design: creating a campaign never sends it. Sending, scheduling and deletion carry destructiveHint, so clients ask for confirmation; read-only tools run without prompts. Users pick scopes on the OAuth consent screen and can change them later. ?readonly=1 drops every write tool, ?toolset=core exposes a compact set for small context windows.
Authentication is OAuth 2.1 with PKCE and dynamic client registration; an API key in the Authorization header also works. A DashaMail account is required.
Список инструментов сервера (60)
Технические названия из tools/list. Нужны только разработчикам.
| account_get | Текущие лимиты аккаунта и число активных подписчиков. Самый дешёвый запрос — годится для проверки работоспособности ключа. limit_members — максимум активных подписчиков по тарифу (0 — лимита нет: тариф поштучный, расход считается письмами), members — сколько их сейчас, limit_emails — остаток писем на поштучных тарифах, expiration_date — до какого числа оплачен месячный тариф. Current account limits and the number of active subscribers. The cheapest request — good for checking that a key works. limit_members — the maximum number of active subscribers allowed by the plan (0 — no limit: the plan is pay-per-email, usage is counted in messages), members — how many there are now, limit_emails — emails remaining on pay-per-email plans, expiration_date — the date the monthly plan is paid until. |
| senders_list | Список адресов, подтверждённых как обратные. Возвращается массивом строк, не более ста записей. В from_email рассылки можно ставить только адрес из этого списка. The list of addresses verified as reply-to addresses. Returned as an array of strings, no more than a hundred entries. Only an address from this list can be used as from_email of a campaign. |
| senders_add | Отправляет на указанный адрес письмо со ссылкой подтверждения. Адрес станет доступен как обратный после того, как получатель перейдёт по ссылке. На адрес уходит письмо со ссылкой; отправителем он станет только после перехода по ней. Действие необратимо: уходят письма. Перед вызовом покажи пользователю параметры и дождись явного подтверждения. Sends a confirmation link to the given address. The address becomes available as a sender after the recipient follows the link. An email with a link is sent to the address; it becomes a sender only after the link is followed. This action is irreversible: emails go out. Before calling, show the parameters to the user and wait for explicit confirmation. |
| domains_list | Домены аккаунта и состояние их DNS-настроек. Значения берутся из последней проверки — чтобы обновить их, вызовите [проверку DNS](https://dashamail.ru/api/account/#check-domains). valid_spf и valid_dkim — прошла ли проверка DNS; double_spf — в зоне две SPF-записи, это ошибка. The account's domains and the state of their DNS settings. The values come from the last check — to refresh them, call the [DNS check](https://dashamail.ru/api/account/#check-domains). valid_spf and valid_dkim — whether the DNS check passed; double_spf — the zone has two SPF records, which is an error. |
| domains_add | Регистрирует домен в аккаунте и возвращает DNS-записи, которые нужно прописать у регистратора. До того как записи появятся в DNS и пройдут [проверку](https://dashamail.ru/api/account/#check-domains), отправка с этого домена не заработает. **Примечание.** Кроме домена отправки можно добавить домен статистики — тогда ссылки отслеживания в письмах будут вести на ваш поддомен, а не на домен DashaMail. Оба параметра можно передать в одном запросе. Возвращает DNS-записи, которые нужно прописать в зоне домена. После этого вызови domains_check. Registers a domain in the account and returns the DNS records to publish with the registrar. Sending from this domain will not work until the records appear in DNS and pass the [check](https://dashamail.ru/api/account/#check-domains). Note. Besides a sending domain you can add a statistics domain — then tracking links in emails will point to your subdomain instead of the DashaMail domain. Both parameters can be passed in one request. Returns the DNS records to publish in the domain's zone. After that, call domains_check. |
| domains_check | Запрашивает DNS и обновляет состояние доменов. Вызывайте после того, как прописали записи у регистратора — распространение изменений обычно занимает от нескольких минут до нескольких часов. Queries DNS and updates the state of the domains. Call it after publishing the records with the registrar — propagation usually takes from a few minutes to a few hours. |
| lists_list | Возвращает все адресные базы аккаунта, от новых к старым, вместе со счётчиками подписчиков по состояниям. Возвращает id, название, число подписчиков и описание дополнительных полей (merge_1 … merge_N) каждой базы. Returns all subscriber lists of the account, newest first, together with subscriber counts by state. Returns the id, name, subscriber count and the description of the additional fields (merge_1 … merge_N) of each list. |
| lists_get | Возвращает одну базу — в том же формате, что и список, но массивом из одного элемента. Отсюда удобно получать состав дополнительных полей перед добавлением подписчиков. Returns one list — in the same format as the listing, but as an array with a single element. This is a convenient place to read the set of additional fields before adding subscribers. |
| lists_create | Создаёт новую адресную базу. Контактные данные (`company`, `address`, `city` и другие) попадают в подвал писем — этого требуют антиспам-политики. Если их не передать, подставятся данные из профиля аккаунта. Creates a new subscriber list. Contact details (`company`, `address`, `city` and others) go into the email footer — anti-spam policies require them. If they are not provided, the account profile data is used. |
| lists_update | Меняет реквизиты базы. Передавайте только те поля, которые нужно изменить — остальные останутся прежними. Состав дополнительных полей здесь не меняется, для этого есть отдельные эндпоинты. Changes the details of a list. Pass only the fields you need to change — the rest stay as they are. The set of additional fields is not changed here; there are separate endpoints for that. |
| fields_add | Добавляет в базу новое дополнительное поле. Оно займёт первый свободный номер `merge_N`. Adds a new additional field to the list. It takes the first free `merge_N` number. |
| fields_update | Меняет параметры существующего поля. Незаданные параметры сохраняют прежние значения. Тип поля изменить нельзя. Changes the settings of an existing field. Parameters that are not given keep their previous values. The field type cannot be changed. |
| lists_unsubscribed | Подписчики, отписавшиеся от рассылок, с датой отписки. Полезно для синхронизации отписок с вашей CRM. Subscribers who unsubscribed from mailings, with the date of unsubscription. Useful for syncing unsubscribes with your CRM. |
| lists_complaints | Подписчики, нажавшие «Это спам» в своём почтовом клиенте. Такие адреса исключаются из рассылок навсегда. Subscribers who pressed "This is spam" in their email client. Such addresses are excluded from mailings permanently. |
| members_search | Постранично возвращает подписчиков базы. **Примечание.** Смещение задаётся параметром `start`, не `offset`. По умолчанию отдаётся 100 записей. Постранично: start — смещение, limit — размер страницы. Точный поиск одного адреса — параметр email. Returns the subscribers of a list page by page. Note. The offset is set by the `start` parameter, not `offset`. By default 100 records are returned. Page by page: start — the offset, limit — the page size. To find one exact address, use the email parameter. |
| members_get | Возвращает записи подписчика по адресу. **Примечание.** Поиск идёт по **всем базам аккаунта**, а не только по указанной в пути. Если адрес есть в нескольких базах, вернутся все записи — различайте их по полю `list_id`. Возвращает member_id — он нужен для members_move и members_copy. Returns the records of a subscriber by address. Note. The search runs across **all lists of the account**, not only the one in the path. If the address is present in several lists, all records are returned — tell them apart by the `list_id` field. Returns member_id, which is needed for members_move and members_copy. |
| members_add | Добавляет один адрес в базу. Для загрузки нескольких адресов используйте [пакетное добавление](https://dashamail.ru/api/lists/#add-members-batch), для файлов — [импорт](https://dashamail.ru/api/lists/#import-members). Перед добавлением адрес проверяется по вашему списку отписок, по чёрному списку аккаунта и по глобальному списку возвратов. Если адрес уже есть в базе, без update=true запрос вернёт ошибку; с update=true — обновит поля. Дополнительные поля — объектом merge: {"merge_1": "Иван"}. Adds one address to a list. To upload several addresses use [batch adding](https://dashamail.ru/api/lists/#add-members-batch), for files use [import](https://dashamail.ru/api/lists/#import-members). Before being added, the address is checked against your unsubscribe list, the account blacklist and the global bounce list. If the address is already in the list, the request fails without update=true; with update=true it updates the fields. Additional fields go as the merge object: {"merge_1": "Ivan"}. |
| members_add_batch | Загружает несколько подписчиков одним запросом. Каждый элемент `batch` — такой же объект, как тело [добавления одного подписчика](https://dashamail.ru/api/lists/#add-member). **Примечание.** С параметром `background` запрос сразу возвращает управление, а загрузка идёт в фоне — так стоит поступать с пакетами в тысячи адресов. Uploads several subscribers in one request. Each element of `batch` is the same object as the body of [adding a single subscriber](https://dashamail.ru/api/lists/#add-member). Note. With the `background` parameter the request returns immediately and the upload runs in the background — that is the right way to handle batches of thousands of addresses. |
| members_update | Обновляет дополнительные поля и состояние подписчика. Подписчик находится по паре «база + адрес» из пути, либо, если передан `member_id` — по нему. Updates the additional fields and the state of a subscriber. The subscriber is found by the "list + address" pair from the path, or by `member_id` if it is given. |
| members_unsubscribe | Переводит подписчика в состояние `unsubscribed` и проставляет время отписки. Если адрес есть в нескольких базах, а `list_id` в пути указывает на конкретную — отписка затронет только её. Moves the subscriber to the `unsubscribed` state and records the time of unsubscription. If the address is present in several lists and `list_id` in the path points to a specific one, only that list is affected. |
| members_move | Переносит активного подписчика в другую базу. Запись меняет принадлежность, идентификатор сохраняется. Перенос считается подпиской на целевую базу — привязанные к ней автоматизации с событием «добавление в базу» сработают. Moves an active subscriber to another list. The record changes ownership, the identifier is kept. The move counts as a subscription to the target list — automations attached to it with the "added to list" event will fire. |
| members_copy | Создаёт копию записи подписчика в другой базе. Исходная запись остаётся на месте; значения дополнительных полей копируются. Creates a copy of the subscriber record in another list. The original record stays where it is; the values of the additional fields are copied. |
| members_activity | События подписчика: отправки, доставки, открытия, клики, возвраты, отписки — с привязкой к рассылкам. Events of a subscriber: sends, deliveries, opens, clicks, bounces, unsubscribes — linked to the campaigns they belong to. |
| members_status | Быстрая проверка: в каком состоянии находится конкретный адрес в базе. Дешевле, чем выгружать подписчика целиком. A quick check: what state a particular address is in within a list. Cheaper than fetching the whole subscriber record. |
| members_check_email | Отвечает на вопрос «можно ли добавить этот адрес в базу». Проверяет его по чёрному списку аккаунта, по отпискам в этой базе, по глобальному списку возвратов, а также формат адреса и принадлежность к одноразовым почтовым сервисам. Полезно вызывать перед [добавлением подписчика](https://dashamail.ru/api/lists/#add-member): так вы заранее отсеете адреса, на которых `POST` всё равно завершится ошибкой, и не потратите на них попытку. **Примечание.** Успешный ответ возвращает адрес в поле `valid` уже нормализованным — регистр и типичные опечатки в домене исправляются. Добавляйте в базу именно это значение. Отказы приходят со статусами `409` и `422`, но различать причины надёжнее по полю `code`: статус лишь делит их на «адрес в чёрном списке» и «адрес непригоден». Answers the question "can this address be added to the list". Checks it against the account blacklist, the unsubscribes of this list and the global bounce list, and also validates the address format and whether it belongs to a disposable email service. Worth calling before [adding a subscriber](https://dashamail.ru/api/lists/#add-member): this filters out addresses on which the `POST` would fail anyway, without spending an attempt on them. Note. A successful response returns the address in the `valid` field already normalised — the case and typical typos in the domain are corrected. Add exactly this value to the list. Rejections come with statuses `409` and `422`, but it is more reliable to tell the reasons apart by the `code` field: the status only splits them into "address is blacklisted" and "address is unusable". |
| imports_start | Ставит в очередь импорт из файла CSV, XLS, XLSX, TXT или ZIP. Файл либо скачивается по ссылке `file`, либо загружается как multipart-поле `import-file`. Соответствие колонок файла и полей подписчика задаётся **номерами колонок, начиная с нуля**: `email=0` означает, что адрес лежит в первой колонке, `merge_1=2` — что первое дополнительное поле лежит в третьей. **Примечание.** В одну базу можно поставить не больше пяти задач импорта одновременно. В режиме `online` импорт запрещён, если в аккаунте уже идёт другой импорт. Импорт фоновый: результат смотри через imports_status. Queues an import from a CSV, XLS, XLSX, TXT or ZIP file. The file is either downloaded from the `file` link or uploaded as the multipart field `import-file`. The mapping between file columns and subscriber fields is set by **column numbers starting from zero**: `email=0` means the address is in the first column, `merge_1=2` means the first additional field is in the third. Note. No more than five import jobs can be queued for one list at a time. In `online` mode an import is rejected if another import is already running in the account. The import runs in the background: check the result through imports_status. |
| imports_status | Возвращает текстовый отчёт о последнем завершённом импорте в базу. Returns a text report on the last completed import into the list. |
| imports_history | Список задач импорта по базе с их состоянием и итогами. The list of import jobs for a list with their state and results. |
| campaigns_list | Возвращает рассылки аккаунта. Удалённые не показываются, если явно не запрошен статус `DELETED`. **Примечание.** Здесь смещение задаётся параметром `offset` (в отличие от подписчиков, где используется `start`). По умолчанию возвращается 100 рассылок. Вёрстка писем в списке не возвращается — за ней campaigns_get с with_html. Статусы: DRAFT черновик, SCHEDULE запланирована, MODERATING на модерации, SENT отправлена. Returns the campaigns of the account. Deleted ones are not shown unless the `DELETED` status is requested explicitly. Note. Here the offset is set by the `offset` parameter (unlike subscribers, where `start` is used). By default 100 campaigns are returned. The email HTML is not returned in the listing — use campaigns_get with with_html for it. Statuses: DRAFT, SCHEDULE scheduled, MODERATING under moderation, SENT sent. |
| campaigns_get | Возвращает рассылку целиком, включая HTML- и текстовую версии письма. Returns the whole campaign, including the HTML and plain text versions of the email. |
| campaigns_create | Создаёт черновик рассылки. Отправка не начинается — для этого нужно [перевести рассылку в статус запуска](https://dashamail.ru/api/campaigns/#update-campaign). Содержимое письма можно передать сразу в `html`, а можно наполнить позже. Создаёт только черновик — письма не уходят. Запуск отдельными инструментами campaigns_schedule и campaigns_send_now. from_email должен быть из senders_list. В html обязательна ссылка отписки вида <a id="unsub_link" href="%ОТПИСАТЬСЯ%">Отписаться</a>, в plain_text — метка %ОТПИСАТЬСЯ%; без них запуск будет отклонён. Creates a campaign draft. Sending does not start — for that the campaign has to be [moved to a launch status](https://dashamail.ru/api/campaigns/#update-campaign). The email content can be passed right away in `html`, or filled in later. Creates a draft only — no emails are sent. Launching is done by the separate tools campaigns_schedule and campaigns_send_now. from_email must come from senders_list. The html must contain an unsubscribe link of the form <a id="unsub_link" href="%ОТПИСАТЬСЯ%">Unsubscribe</a>, and plain_text must contain the %ОТПИСАТЬСЯ% marker; without them the launch is rejected. |
| campaigns_update | Меняет только переданные поля рассылки. Изменять можно рассылки в статусах DRAFT, SCHEDULE, TRIGGER и TEMPLATE; уже отправляющуюся изменить нельзя. Запуск отправки — отдельными инструментами campaigns_schedule и campaigns_send_now. Changes only the fields that are passed. Campaigns in the DRAFT, SCHEDULE, TRIGGER and TEMPLATE statuses can be changed; a campaign that is already sending cannot. Launching is done by the separate tools campaigns_schedule and campaigns_send_now. |
| campaigns_schedule | Запускает черновик по расписанию: рассылка уйдёт всей аудитории базы (с учётом сегмента) в delivery_time по московскому времени. Перед запуском API проверяет тему, отправителя, текст письма и ссылку отписки. Отменить через API нельзя — только в кабинете. Действие необратимо: уходят письма. Перед вызовом покажи пользователю параметры и дождись явного подтверждения. Launches a draft on a schedule: the campaign goes out to the whole audience of the list (respecting the segment) at delivery_time, Moscow time. Before launching, the API checks the subject, the sender, the email body and the unsubscribe link. It cannot be cancelled through the API — only in the account interface. This action is irreversible: emails go out. Before calling, show the parameters to the user and wait for explicit confirmation. |
| campaigns_send_now | Запускает черновик немедленно: рассылка уходит всей аудитории базы (с учётом сегмента) сразу после модерации. Перед запуском API проверяет тему, отправителя, текст письма и ссылку отписки. Отменить через API нельзя — только в кабинете. Действие необратимо: уходят письма. Перед вызовом покажи пользователю параметры и дождись явного подтверждения. Launches a draft immediately: the campaign goes out to the whole audience of the list (respecting the segment) right after moderation. Before launching, the API checks the subject, the sender, the email body and the unsubscribe link. It cannot be cancelled through the API — only in the account interface. This action is irreversible: emails go out. Before calling, show the parameters to the user and wait for explicit confirmation. |
| campaigns_pause | Приостанавливает идущую рассылку. Уже отправленные письма не отзываются. Pauses a campaign that is being sent. Emails that have already gone out are not recalled. |
| campaigns_resume | Продолжает рассылку, поставленную на паузу, с того места, где она остановилась. Continues a paused campaign from the point where it stopped. |
| campaigns_unschedule | Возвращает запланированную рассылку в черновик: статус `SCHEDULE`, `MODERATING`, `CREATED` или `WAITING` становится `DRAFT`. Письма ещё не уходили, поэтому это не отмена отправки, а отказ от запуска — рассылку можно поправить и запланировать заново тем же `PUT /campaigns/{campaign_id}`. Сплит-варианты возвращаются вместе с основной. Идущую отправку останавливает `POST /campaigns/{campaign_id}/pause`, уже отправленные письма не отзываются. Обратное действие к campaigns_schedule и campaigns_send_now, пока письма не ушли: рассылка возвращается в черновик, её можно поправить и запланировать заново. Уже идущую отправку это не останавливает — для неё campaigns_pause. Returns a scheduled campaign to draft: the `SCHEDULE`, `MODERATING`, `CREATED` or `WAITING` status becomes `DRAFT`. No emails have gone out yet, so this is not a cancellation of sending but a withdrawal of the launch — the campaign can be corrected and scheduled again with the same `PUT /campaigns/{campaign_id}`. Split variants are returned along with the main campaign. Sending that is already running is stopped by `POST /campaigns/{campaign_id}/pause`; emails already sent are not recalled. The inverse of campaigns_schedule and campaigns_send_now while no emails have gone out: the campaign returns to draft, and can be corrected and scheduled again. It does not stop sending that is already running — campaigns_pause does that. |
| campaigns_resend_unopened | Создаёт новую рассылку по тем получателям исходной, кто её не открыл. Обычный приём — повторить письмо через несколько дней с другой темой. Действие необратимо: уходят письма. Перед вызовом покажи пользователю параметры и дождись явного подтверждения. Creates a new campaign for those recipients of the original who did not open it. The usual practice is to repeat the email a few days later with a different subject. This action is irreversible: emails go out. Before calling, show the parameters to the user and wait for explicit confirmation. |
| campaigns_copy | Создаёт копию рассылки вместе с вёрсткой. Копия отправленной или заблокированной рассылки всегда получает статус `DRAFT`. Удобный способ сделать новую рассылку по образцу старой: копия создаётся черновиком. Creates a copy of a campaign together with its HTML. A copy of a sent or blocked campaign always gets the `DRAFT` status. A convenient way to build a new campaign from an old one: the copy is created as a draft. |
| folders_list | Список папок, по которым разложены рассылки. The list of folders the campaigns are sorted into. |
| campaigns_move_to_folder | Перекладывает рассылку в указанную папку. Moves a campaign into the given folder. |
| templates_list | Возвращает рассылки в статусе `TEMPLATE` — без вёрстки, только идентификатор, название и папку. Чтобы получить HTML, запросите рассылку через [её эндпоинт](https://dashamail.ru/api/campaigns/#get-campaign). Returns campaigns in the `TEMPLATE` status — without the HTML, only the identifier, the name and the folder. To get the HTML, request the campaign through [its endpoint](https://dashamail.ru/api/campaigns/#get-campaign). |
| templates_gallery | Возвращает сохранённые HTML-шаблоны аккаунта вместе с вёрсткой, от новых к старым. Returns the account's saved HTML templates together with their markup, newest first. |
| templates_create | Сохраняет вёрстку как HTML-шаблон. В `template` можно передать либо саму вёрстку, либо **число** — идентификатор рассылки, чью вёрстку нужно сохранить. Saves markup as an HTML template. In `template` you can pass either the markup itself or a **number** — the identifier of the campaign whose markup should be saved. |
| automations_list | Возвращает автоматизации аккаунта вместе с настройками события и задержки. Returns the account's automations together with their event and delay settings. |
| automations_trigger | Отправляет письмо автоматизации конкретному подписчику, не дожидаясь события. Удобно для проверки вёрстки и для сценариев, где момент отправки решает ваша система. **Примечание.** Предыдущая отправка этого письма тому же подписчику сбрасывается, поэтому повторный запуск сработает даже если письмо уже уходило. Действие необратимо: уходят письма. Перед вызовом покажи пользователю параметры и дождись явного подтверждения. Sends an automation email to a particular subscriber without waiting for the event. Useful for checking the markup and for scenarios where your own system decides when to send. Note. The previous send of this email to the same subscriber is reset, so a repeated trigger works even if the email has already gone out. This action is irreversible: emails go out. Before calling, show the parameters to the user and wait for explicit confirmation. |
| reports_summary | Главные показатели рассылки одним объектом. Отсюда стоит начинать: остальные отчёты нужны, когда требуется детализация. **Примечание.** Параметр `fast` отдаёт заранее посчитанные значения — это заметно быстрее, но несовместимо с фильтром по времени. Без campaign_id (или с 0) — сводка по всему аккаунту за период time_start…time_end; detailed=1 разбивает её по рассылкам. Метрики: sent отправлено, unique_opened уникальные открытия, opened все открытия, unique_clicked уникальные клики, unsubscribed, complained, hard/soft — возвраты. OR = unique_opened / sent, CTR = unique_clicked / sent, CTOR = unique_clicked / unique_opened. За период sent не возвращается. The main metrics of a campaign in a single object. This is the place to start: the other reports are for when you need a breakdown. Note. The `fast` parameter returns pre-calculated values — noticeably faster, but incompatible with filtering by time. Without campaign_id (or with 0) — a summary for the whole account over the period time_start…time_end; detailed=1 breaks it down by campaign. Metrics: sent, unique_opened unique opens, opened all opens, unique_clicked unique clicks, unsubscribed, complained, hard/soft — bounces. OR = unique_opened / sent, CTR = unique_clicked / sent, CTOR = unique_clicked / unique_opened. Over a period, sent is not returned. |
| reports_recipients | Возвращает подписчиков, с которыми произошло указанное событие. Один и тот же формат для семи метрик: `sent`, `delivered`, `opened`, `clicked`, `bounced`, `complained`, `unsubscribed`. metric: sent, delivered, opened, clicked, bounced, complained, unsubscribed. Постранично через start/limit. Returns the subscribers for whom the given event occurred. The same format for seven metrics: `sent`, `delivered`, `opened`, `clicked`, `bounced`, `complained`, `unsubscribed`. metric: sent, delivered, opened, clicked, bounced, complained, unsubscribed. Paged through start/limit. |
| reports_events | Все события рассылки в одном потоке, с фильтрами по времени, типу и подписчику. Подходит для синхронизации событий с вашей аналитикой. **Примечание.** По умолчанию берутся события за сегодня. Чтобы получить события за другой период, задайте `time_start` и `time_end` явно. All events of a campaign in one stream, with filters by time, type and subscriber. Suitable for syncing events with your own analytics. Note. By default the events of the current day are taken. To get events for another period, set `time_start` and `time_end` explicitly. |
| reports_links | Сколько раз кликнули по каждой ссылке письма, от популярных к редким. How many times each link in the email was clicked, from the most popular to the rarest. |
| reports_link_clickers | Подписчики, кликнувшие по указанной ссылке, со временем клика. Выборка ограничена последним годом. The subscribers who clicked the given link, with the time of the click. The selection is limited to the last year. |
| reports_bounces | Группировка возвратов по SMTP-кодам с расшифровкой. Помогает понять, дело в несуществующих адресах или в репутации отправителя. Bounces grouped by SMTP code with an explanation. Helps to tell whether the cause is non-existent addresses or the sender's reputation. |
| reports_domains | Доставляемость и вовлечённость в разрезе почтовых провайдеров. Проседание по одному домену обычно означает проблему с репутацией именно у него. Deliverability and engagement broken down by mailbox provider. A drop at one domain usually means a reputation problem with that provider specifically. |
| reports_geo | Распределение событий по регионам. Ключ — код региона, значение — количество событий. The distribution of events by region. The key is the region code, the value is the number of events. |
| reports_clients | Чем получатели читают письмо: браузеры, десктопные клиенты, мобильные устройства. Полезно перед изменением вёрстки. What recipients read the email with: browsers, desktop clients, mobile devices. Useful before changing the markup. |
| transactional_send | Ставит письмо в очередь отправки и сразу возвращает его идентификатор. Фактическая доставка происходит асинхронно — следите за ней через [проверку статуса](https://dashamail.ru/api/transactional/#check-message) или webhooks. Нужны как минимум три вещи: получатель, отправитель (`from_email` либо заголовок `From` внутри `headers`) и текст письма (`message` либо `plain_text`). **Примечание.** В `to` можно перечислить несколько адресов через запятую. Тогда каждому уйдёт отдельное письмо, а в `message_id` можно передать столько же идентификаторов, тоже через запятую. Одно письмо одному или нескольким адресам (to через запятую). Домен from_email должен быть подтверждён (domains_list). message_id — свой идентификатор для идемпотентности и последующего transactional_get. Действие необратимо: уходят письма. Перед вызовом покажи пользователю параметры и дождись явного подтверждения. Queues the email for sending and immediately returns its identifier. Actual delivery happens asynchronously — follow it through the [status check](https://dashamail.ru/api/transactional/#check-message) or webhooks. At least three things are needed: a recipient, a sender (`from_email` or the `From` header inside `headers`) and the email body (`message` or `plain_text`). Note. Several addresses can be listed in `to`, separated by commas. Then each one gets a separate email, and `message_id` may carry the same number of identifiers, also comma-separated. One email to one or several addresses (to, comma-separated). The domain of from_email must be verified (domains_list). message_id is your own identifier, used for idempotency and for a later transactional_get. This action is irreversible: emails go out. Before calling, show the parameters to the user and wait for explicit confirmation. |
| transactional_get | Возвращает текущий статус письма и historию его событий. Данные появляются через несколько секунд после отправки. **Примечание.** Поиск по конкретному письму доступен за последние шесть месяцев. За более старыми данными обращайтесь к [журналу](https://dashamail.ru/api/transactional/#get-log). Возвращает текущий статус и историю: 5 Sent, 3 Delivered, 7 Opened, 6 Clicked, 4 Bounced, 9 Complained, 8 Unsubscribed. Глубина — 6 месяцев. Returns the current status of the email and the history of its events. The data appears a few seconds after sending. Note. Search by a particular email is available for the last six months. For older data use the [log](https://dashamail.ru/api/transactional/#get-log). Returns the current status and the history: 5 Sent, 3 Delivered, 7 Opened, 6 Clicked, 4 Bounced, 9 Complained, 8 Unsubscribed. The depth is 6 months. |
| transactional_log | События транзакционных писем аккаунта с фильтрами. Основной инструмент для разбора инцидентов: «почему клиент не получил письмо». Ошибка с code 34 означает, что в аккаунте не настроен домен транзакционной отправки (domains_list) — журнала нет, это не сбой. The events of the account's transactional emails with filters. The main tool for investigating incidents: "why did the customer not get the email". An error with code 34 means that no transactional sending domain is configured in the account (domains_list) — there is no log, and this is not a failure. |
| transactional_stats | Агрегированные показатели транзакционных писем за период, разложенные по временным интервалам. Годится для построения графиков доставляемости. **Примечание.** Ширина интервала подбирается по периоду автоматически: пять минут для `1h`, час для `24h`, сутки для `7d` и `30d`. Ошибка с code 34 означает, что в аккаунте не настроен домен транзакционной отправки — статистики нет, это не сбой. Aggregated metrics of transactional emails over a period, broken down into time intervals. Suitable for building deliverability charts. Note. The width of the interval is chosen automatically from the period: five minutes for `1h`, an hour for `24h`, a day for `7d` and `30d`. An error with code 34 means that no transactional sending domain is configured in the account — there are no statistics, and this is not a failure. |
| webhooks_list | Текущие адреса, на которые уходят события массовых рассылок — объект вида «событие → URL». The current addresses that campaign events are sent to — an object of the form "event → URL". |