getpoststack/mcp

Перемещает рабочий процесс из черновика/приостановленного в активный, чтобы новые события-триггеры запускали выполнение. Когда использовать: после того как шаги настроены и вы проверили конвейер с помощью ручного триггера. Возвращает: рабочий процесс со статусом "active". Пример: { id: "wf_abc123" }

Добавляет одного или нескольких контактов в сегмент. Когда использовать: зачислить конкретные контакты в существующий сегмент (например, агент собрал список и хочет его материализовать). Возвращает: { added: number } или подобный индикатор успеха. Пример: { id: "seg_abc", contact_ids: ["con_1", "con_2"] }

Блокирует email-адрес, чтобы на него больше не отправлялись письма. Когда использовать: получатель попросил удалить его из списка (вручную), или вы импортируете предыдущие отказы/жалобы. Возвращает: структурированную запись в списке заблокированных. Пример: { email: "bouncy@aol.com", reason: "hard_bounce" }

Добавляет узел в граф рабочего процесса и (по умолчанию) соединяет его после существующего узла. Когда использовать: достраивать автоматизацию после `create_workflow`. Конфигурации узлов: - `send_email`: { templateId: "tpl_..." } — отправляет шаблон контакту. - `wait`: { duration: <int>, unit: "hours"|"days" } — относительная задержка. Или ожидание до времени: { mode: "until", untilTime: "HH:MM" } (следующее наступление, UTC) или { mode: "until", untilDate: "2026-01-02T09:00:00Z" }. - `condition`: { field: "<name>", comparator: "equals"|"not_equals"|"contains"|"not_contains"|"is_set"|"is_not_set", value: "..." }. `field` — это поле контакта верхнего уровня (email/firstName/lastName/unsubscribed) или имя свойства. Ветвление выполняется через РЁБРА, а не конфигурацию: соедините исходящие рёбра "match" и/или "no_match" с помощью `connect_workflow_nodes`. Ветвь без ребра завершает выполнение. - `webhook`: { url: "https://..." } — отправляет POST-запрос с JSON контакта и рабочего процесса на внешний URL (защищён от SSRF). По умолчанию новый узел соединяется безусловным ребром от `after_node` (или, если он опущен, от единственного открытого узла — триггера в новом рабочем процессе). Опустите `after_node` для ветвей и соединяйте рёбра самостоятельно. Возвращает: { public_id } — идентификатор нового узла для ссылки в `connect_workflow_nodes`. Пример: { id: "wf_abc123", type: "send_email", config: { templateId: "tpl_welcome" } }

Получает статистику по рассылкам — либо по одной рассылке (с разбивкой по вариантам, если A/B-тест), либо по лидерборду, отсортированному по выбранной метрике. Когда использовать: агент хочет найти самую эффективную рассылку за период или углубиться в статистику конкретной рассылки. Передайте broadcast_id для одиночного режима или { since, best_metric } для режима лидерборда. Возвращает: одиночный режим → { broadcast: { id, subject, status, sent_at, total_recipients, delivered, opened, clicked, bounced, open_rate, click_rate }, variants: [...]|null }. Лидерборд → { metric, since, broadcasts: [...] } отсортирован по метрике по убыванию. Пример: { broadcast_id: "br_abc" } — одиночный режим. Пример: { since: "2026-03-01T00:00:00Z", best_metric: "click_rate", limit: 5 } — режим лидерборда.

Отменить поставленную в очередь или отправляемую рассылку. Когда использовать: остановить рассылку в процессе отправки. Уже доставленные сообщения отозвать нельзя. Возвращает: { success: boolean }. Пример: { id: "br_abc" }

Отменить запланированное письмо, которое ещё не попало в очередь отправки. Когда использовать: агент хочет отменить запланированную отправку до того, как она произойдёт. Нельзя отменить уже доставленные письма. Возвращает: { success: boolean }. Пример: { id: "em_7kf2x9" }

Сбросить пароль IMAP/SMTP почтового ящика. Когда использовать: смена после подозрения на утечку или при передаче новому сотруднику. Возвращает: { success: boolean }. Пример: { id: "mb_abc", password: "<новый надёжный>" }

Проверяет, можно ли ПРЯМО СЕЙЧАС безопасно отправлять письма с указанного адреса отправителя. Когда использовать: ПЕРЕД отправкой контента, созданного агентом, с нестандартного домена. Объединяет в одном ответе проверку DNS (DKIM/SPF/DMARC), показатели отказов и жалоб за 30 дней, а также стандартные предупреждения о доставляемости (нет текстовой версии письма, несоответствие доменов ссылок, слишком большой HTML и т.д.). Возвращает: { from, domain, domain_verified, dkim, spf, dmarc, return_path, volume_30d, bounce_rate, complaint_rate, warnings[] }. Пример: { from: "Acme <hi@acme.io>" }

Добавьте ребро между двумя узлами. Когда использовать: соединение условных ветвей, слияние ветвей обратно или любое явное соединение, которое не сделал add_workflow_node. - Безусловное ребро (источник без условия): не указывайте branch. - Условный источник: установите branch в "match" (предикат истинен) или "no_match" (предикат ложен). Узел может иметь не более одного безусловного исходящего ребра; условие — не более одного "match" и одного "no_match". Возвращает: { success: true }. Пример: { id: "wf_abc123", from: "wfn_cond", to: "wfn_email", branch: "match" }

Создайте новый ключ API PostStack. Полный ключ возвращается ОДИН раз в этом ответе и не может быть получен снова. Когда использовать: агенту нужно подготовить учётные данные для новой интеграции. Выберите "sending_access" для ключей только на отправку (рекомендуется для серверов приложений) или "full_access" для управления. Возвращает: сформированный ключ, включающий секретную строку — покажите его один раз и скажите пользователю сохранить его надёжно. Пример: { name: "Backend prod", permission: "sending_access" }

Создать черновик рассылки для сегмента. Когда использовать: агент собрал тело кампании + id сегмента и хочет подготовить его к проверке или запланированной отправке. Создан в статусе "draft", вызовите send_broadcast для отправки. Возвращает: сформированную рассылку (id, subject, status=draft, количество получателей появится при отправке). Пример: { segment_id: "seg_abc", from: "Acme <hi@acme.io>", subject: "Апрельское обновление", html }

Создаёт новый контакт (человека, который может получать письма и рассылки). Когда использовать: добавить новую регистрацию, программную запись или разовое добавление. Для массового импорта лучше использовать API-эндпоинт импорта. Возвращает: сформированный контакт (id, email, имена, свойства, createdAt). Пример: { email: "ada@lovelace.io", first_name: "Ada", properties: { plan: "pro" } }

Определяет пользовательское свойство контакта (типизированную схему для поля contact.properties). Когда использовать: агент расширяет модель данных контакта — например, добавляет поле "plan" или "company", по которому другие инструменты могут фильтровать. Возвращает: сформированное определение свойства. Пример: { name: "plan", label: "План подписки", type: "select", options: ["free","pro","scale"] }

Добавить новый отправляющий домен в PostStack. Когда использовать: клиент подключает новый отправляющий домен. Ответ содержит DNS-записи (SPF, DKIM, DMARC, return-path), которые пользователь должен настроить, чтобы verify_domain выполнился успешно. Возвращает: оформленный домен с dnsRecords[] и статусом pending. Пример: { name: "send.acme.io", region: "eu-west-1" }

Выделите почтовый ящик (IMAP/SMTP-входящие) на подтверждённом домене. Когда использовать: агент настраивает настоящий читаемый человеком ящик (например support@acme.io). Пароль нужен для входа по IMAP/SMTP. Домен должен быть уже подтверждён. Возвращает: сформированный почтовый ящик с полями emailAddress и quotaBytes. Пример: { domainId: 42, localPart: "support", password: "<strong>", displayName: "Acme Support" }

Создаёт статический сегмент контактов (список, управляемый вручную). Когда использовать: агенту нужен именованный набор контактов для отправки рассылки. Добавляйте участников через add_contacts_to_segment. Возвращает: сформированный сегмент с id и contactCount=0. Пример: { name: "Запуск весной 2026" }

Создаёт встраиваемую форму регистрации. Отправки создают контакт и опционально добавляют его в сегмент / тему подписки. Когда использовать: создание новой формы сбора лидов для целевой страницы. Возвращает: сформированную форму с publicId — используйте его в коде для встраивания. Пример: { name: "Newsletter signup", segment_id: "seg_newsletter", fields: [{ name: "email", type: "email", label: "Email", required: true }] }

Создайте тему подписки (название предпочтения opt-in/opt-out, например "Product Updates"). Когда использовать: агент настраивает детализированные предпочтения, чтобы контакты могли подписываться по каждой теме отдельно, а не по принципу «всё или ничего». Возвращает: оформленную тему. Пример: { name: "Product Updates", description: "Ежемесячные новости продукта" }

Создайте новый шаблон email с плейсхолдерами {{variable}}. Когда использовать: хранить многократно используемое тело письма, которое агент (или приложение) будет отправлять. Только что созданные шаблоны не опубликованы — перед отправкой вызовите publish_template. Возвращает: сформированный шаблон с id, version, published=false. Пример: { name: "welcome-v3", subject: "Welcome {{first_name}}", html: "<p>Hi {{first_name}}</p>" }

Подписывает URL на получение уведомлений о событиях через подписанные POST-запросы. Когда использовать: агент настраивает интеграцию, которая должна реагировать на события почты/контактов/доменов в реальном времени. Возвращает: сформированный вебхук с id, url, events[], active=true. Пример: { url: "https://hooks.acme.io/poststack", events: ["email.bounced", "email.complained"] }

Создать новый workflow (status=draft). Начинается с одного trigger-узла, других узлов нет. Когда использовать: начать новую автоматизацию. Добавляйте узлы через add_workflow_node, связывайте ветки через connect_workflow_nodes, затем вызывайте activate_workflow. Возвращает: { workflow }, созданную строку workflow с publicId, который вы будете использовать для последующих вызовов графа. Пример: { name: "New-user onboarding", trigger_type: "contact.created" }

Навсегда удаляет контакт (необратимо - для отказов от подписки используйте unsubscribe_contact). Когда использовать: удаление по GDPR или удаление тестового контакта. Для отказов от подписки используйте unsubscribe_contact - он сохраняет историю. Возвращает: { success: boolean }. Пример: { id: "con_abc123" }

Удаляет определение пользовательского свойства контакта. Существующие значения контакта для этого свойства удаляются. Когда использовать: свойство не используется и выводится из эксплуатации. Согласуйте с пользователем — значения невосстановимы. Возвращает: { success: boolean }. Пример: { id: 5 }

Навсегда удалить домен отправки (необратимо: исторические записи писем остаются). Когда использовать: домен выводится из эксплуатации. Сначала подтвердите у пользователя, так как будущие отправки с любого совпадающего обратного адреса завершатся ошибкой. Возвращает: { success: boolean }. Пример: { id: 42 }.

Навсегда удаляет почтовый ящик и все его письма. Когда использовать: при выведении почтового ящика из эксплуатации. НЕОБРАТИМО — подтвердите у пользователя, письма пропадут. Возвращает: { success: boolean }. Пример: { id: "mb_abc" }

Удаляет определение сегмента. Контакты в нём НЕ удаляются. Когда использовать: убрать устаревший сегмент. Подтвердите с пользователем. Возвращает: { success: boolean }. Пример: { id: "seg_abc" }

Навсегда удалить форму регистрации. Встроенные копии на существующих страницах перестанут работать с ошибкой 404. Когда использовать: при выводе формы из эксплуатации. Если возможно, используйте update_signup_form с параметром active=false, если в будущем вы захотите восстановить форму. Возвращает: { success: boolean }. Пример: { id: "sf_xyz789" }

Удаляет тему подписки навсегда. Подписки удаляются. Когда использовать: тему выводят из эксплуатации. Подтвердите с пользователем. Возвращает: { success: boolean }. Пример: { id: "top_abc" }

Навсегда удалить шаблон (необратимо). Когда использовать: нужно удалить неиспользуемый шаблон. Подтвердите у пользователя — письма, ссылающиеся на этот template_id, не будут отправлены. Возвращает: { success: boolean }. Пример: { id: "tpl_abc" }

Навсегда удалить webhook endpoint. Когда использовать: интеграция удаляется. Подтвердите с пользователем: события больше не будут доставляться. Возвращает: { success: boolean }. Пример: { id: 17 }.

Навсегда удалить workflow и его граф (узлы + связи). Запуски в процессе НЕ отменяются: они завершаются на работающем движке. Когда использовать: вывод automation из эксплуатации. Используйте pause_workflow, чтобы остановить новые запуски, сохранив определение. Возвращает: { success: boolean }. Пример: { id: "wf_abc123" }

Построить каркас черновика ответа на входящее письмо — правильная цепочка обсуждения, цитируемый оригинал, приветствие/прощание, предложенные отправитель и тема. Только эвристика; агент заполняет текст письма. Когда использовать: агент получил входящее письмо и хочет ответить. Вызовите это, чтобы получить заготовку черновика, заполните body_placeholder фактическим ответом, затем вызовите reply_to_inbound_email. Возвращает: { inbound, suggested_from, suggested_subject, salutation, body_placeholder, quoted_html, quoted_text, threading: { in_reply_to, references }, suggested_html, suggested_text }. Пример: { inbound_id: 7, tone: "friendly" }

Создаёт копию существующего шаблона (новый id, то же тело, к названию добавляется " (копия)"). Когда использовать: агент хочет разветвить шаблон перед редактированием, чтобы оригинал остался нетронутым. Возвращает: сформированный новый шаблон (неопубликованный черновик). Пример: { id: "tpl_abc" }

Выводит список контактов, которые получили рассылку, но НЕ перешли ни по одной отслеживаемой ссылке в ней. Когда использовать: для повторной кампании «тем, кто видел, но не среагировал». Используйте вместе с create_segment + send_broadcast (или send_email), чтобы повторно вовлечь их. Возвращает: { broadcast: { id, subject }, count, contacts: [{ id, email, first_name, last_name }] }. Пример: { broadcast_id: "br_abc", limit: 500 }

Пересылает входящее письмо другим получателям с возможностью добавления сопроводительной заметки. Когда использовать: перенаправить сообщение коллеге или на другой адрес. Возвращает: { id } отправленного исходящего письма. Пример: { id: 7, from: "support@acme.io", to: ["dev@acme.io"], message: "FYI" }

Получить метаданные API-ключа (секрет никогда не возвращается после создания). Когда использовать: чтобы подтвердить разрешения, режим или временную метку последнего использования ключа перед его отзывом. Возвращает: сформированный ключ без секрета. Пример: { id: 17 }

Получает детали рассылки и сводную статистику доставки. Когда использовать: отчёт о результатах отправки (доставлено/открыто/переходы/отказы) для конкретной рассылки. Возвращает: сформированную рассылку (тема, статус, количество получателей). Пример: { id: "br_abc" }

Получить полные данные о контакте по идентификатору. Когда использовать: просмотр свойств конкретного контакта, статуса подписки или последней активности. Возвращает: сформированный контакт с email, именами, свойствами, флагом отписки, createdAt. Пример: { id: "con_abc123" }

Получает ленту недавних email-событий контакта, сгруппированную по типу события (отправлено / доставлено / открыто / переход / отказ / жалоба / неудача). Когда использовать: изучить историю вовлеченности конкретного контакта перед отправкой — например, был ли отказ в последней кампании, как часто открывает, когда был последний переход. Передайте email ИЛИ id; email запускает поиск, id — прямой доступ. Возвращает: { contact_id, email, total, events: { sent, delivered, opened, clicked, bounced, complained, failed, other } }, где каждый элемент — массив { event_id, event_type, created_at, email_id, subject, from, geo_country, ua_client, is_prefetch, metadata }. Пример: { email: "ada@lovelace.io", limit: 20 }

Ищет контакт по его email-адресу. Когда использовать: у агента есть email-адрес (например, из вебхука, регистрации или сообщения пользователя), и ему нужна полная запись контакта без постраничного обхода list_contacts. Возвращает 404, если контакта с таким email нет — используйте create_contact, чтобы добавить его. Возвращает: сформированный контакт (id, email, names, properties, unsubscribed, createdAt). Пример: { email: "ada@lovelace.io" }

Вывести список тем подписки, на которые контакт в данный момент подписан. Когда использовать: проверить, подписан ли контакт на конкретную тему перед отправкой. Возвращает: { items: [{ topicId, subscribedAt }] }. Пример: { contact_id: "con_abc" }

Читает сигналы доставляемости от ISP для отправляющего домена. Когда использовать: проверять последние данные Gmail Postmaster, Microsoft SNDS и Yahoo/FBL, собранные для домена, например, чтобы объяснить падение доставляемости или подтвердить, что уровень спама в норме перед массовой рассылкой. Возвращает: { domainId, signals[] (последние по провайдеру/источнику/метрике), gmailSpamRate, outlookHealth, fblComplaints30d }. Пример: { id: "dom_abc123" }

Получает детали домена, включая DNS-записи и статус верификации. Когда использовать: читать DNS-записи для отображения или проверять, верифицирован ли домен перед отправкой. Возвращает: сформированный домен (status, dnsRecords[], tracking flags, verifiedAt). Пример: { id: 42 }

Получить полные сведения и временную шкалу событий для конкретного письма по его идентификатору. Когда использовать: выяснить, почему одно письмо не доставлено/отклонено, или подтвердить доставку для одной отправки. Возвращает: сформированную запись письма + события (queued, sent, delivered, opened, clicked, bounced). Пример: { id: "em_7kf2x9" }

Получить сводку по вовлеченности одного контакта: сегмент, счётчики за всё время, процент открытий/кликов, последнее открытие/клик, топ-теги. Когда использовать: агент хочет оценить контакт перед отправкой — например, «часто ли Ада открывает письма?», «стоит ли исключить её из повторной активации?». Отличается от get_contact_activity, который возвращает сырую временную ленту. Возвращает: { segment, last_engaged_at, engagement_calculated_at, lifetime_sent, lifetime_delivered, lifetime_opened, lifetime_clicked, open_rate, click_rate, last_open, last_click, top_tags: [{ tag, count }] }. Пример: { email: "ada@lovelace.io" }

Получить полные заголовки и тело полученного входящего письма. Когда использовать: прочитать конкретное сообщение перед составлением ответа (далее используйте draft_from_thread или reply_to_inbound_email). Возвращает: структурированное входящее письмо с html/text телом и заголовками. Пример: { id: 7 }

Получить метаданные почтового ящика: статус, квоту, последний вход. Когда использовать: проверять конкретный ящик перед обновлением или удалением. Возвращает: сформированный объект почтового ящика. Пример: { id: "mb_abc" }

Получает детали сегмента и количество участников. Когда использовать: подтвердить contactCount сегмента перед отправкой рассылки (чтобы оценить объём). Возвращает: сформированный сегмент (name, contactCount, createdAt). Пример: { id: "seg_abc" }

Получить полные сведения о форме регистрации, включая её поля, целевой сегмент и количество отправок. Когда использовать: просмотр полей перед встраиванием или проверка количества отправок, полученных формой. Возвращает: сформированную форму с fields[], segmentId, topicId, submissionCount. Пример: { id: "sf_xyz789" }

Получить полное тело, тему и переменные шаблона. Когда использовать: прочитать исходный HTML/текст перед редактированием, или извлечь список переменных, чтобы знать, что передавать. Возвращает: оформленный шаблон с htmlBody, textBody, variables[], version. Пример: { id: "tpl_abc" }

Получить детали вебхука. Когда использовать: просмотреть URL, список событий или статус активности для конкретного вебхука. Возвращает: сформированный вебхук. Пример: { id: 17 }

Список последних попыток доставки для webhook (status, response code, timestamps). Когда использовать: отладка, почему интеграция не получает события — проверьте ошибки перед повторной отправкой. Возвращает: { data: [...deliveries], meta } — paginated. Пример: { id: 17, per_page: 50 }

Получить метаданные рабочего процесса и его граф (узлы + рёбра). Когда использовать: просмотр структуры автоматизации (конфигурация узлов, соединение узлов) перед активацией или редактированием. Возвращает: сформированный рабочий процесс плюс nodes[] (каждый с public_id, type, config) и edges[] (from_public_id → to_public_id, с branch "match"/"no_match" из узлов условий; null = безусловный). Пример: { id: "wf_abc123" }

Запускает предварительную проверку на спам с помощью Rspamd для черновика письма и возвращает оценку, действие и символы по каждому правилу. Когда использовать: ПЕРЕД отправкой контента, сгенерированного агентом. Оценка (0–15+) и действие (no_action / greylist / add_header / soft_reject / reject) показывают, будет ли письмо скорее всего отфильтровано. Символы перечисляют конкретные сработавшие правила. Возвращает: { score, action, symbols[], skipped, suggestions[] } — suggestions[] формируется из символов с оценкой > 1. Пример: { from: "Acme <hi@acme.io>", to: ["a@b.io"], subject: "Welcome", html: "<p>hi</p>" }

List API keys (только префикс возвращается, никогда полный секрет). Когда использовать: аудит, какие ключи существуют, найти id ключа для отзыва. Возвращает: { keys: [{ id, name, keyPrefix, permission, mode, ... }] }. Пример: { per_page: 50 }

Список рассылок. Когда использовать: найти недавние кампании, проверить, какие рассылки были отправлены, или выбрать одну для просмотра с помощью get_broadcast. Возвращает: { items[], meta } - постранично сформированные рассылки со статусом и количеством. Пример: { per_page: 20 }

Вывести все пользовательские свойства контактов для этой учётной записи. Когда использовать: узнать, какие пользовательские поля доступны перед созданием или обновлением контактов. Возвращает: { items: [property, ...] }. Пример: {}

Выводит список контактов с возможностью поиска и фильтрации по сегменту. Когда использовать: просмотр контактной книги, поиск кандидатов по фрагменту email/имени или список участников сегмента. Возвращает: { items[], meta } — контакты с постраничной разбивкой. Пример: { search: "@acme.io", segment_id: "seg_xyz" }

Список отправляющих доменов. Когда использовать: выбрать, с какого домена отправлять, или проверить, какие домены верифицированы. Возвращает: { domains: [...] } — массив доменов с их статусом и флагами отслеживания. Пример: { per_page: 50 }

Выводит список ранее отправленных писем с опциональными фильтрами и пагинацией. Когда использовать: сортировка доставки, просмотр истории конкретного получателя или фильтрация по статусу/тегу/дате. Возвращает: { items[], meta } - пагинированные письма со статусом, получателем, темой, временными метками. Пример: { status: "bounced", date_from: "2026-04-10" }

Перечисляет вложения во входящем письме (имя файла, размер, contentType). Когда использовать: решить, нужно ли загружать вложения перед пересылкой или обработкой. Возвращает: { items: [{ filename, contentType, size }] }. Пример: { id: 7 }

Вывести входящие письма, полученные почтовыми ящиками на этом аккаунте. Когда использовать: сортировка входящих обращений в поддержку, поиск последнего сообщения для просмотра или фильтрация сообщений, требующих ответа. Возвращает: объект вида { data: [...], meta } — для каждого сообщения: id, from, subject, receivedAt. Пример: { per_page: 20, domain: "acme.io" }

Перечислить почтовые ящики по всем доменам. Когда использовать: посмотреть, какие почтовые ящики существуют, найти идентификатор почтового ящика по адресу электронной почты. Возвращает: { items[], meta } — почтовые ящики с постраничной разбивкой. Пример: { per_page: 50 }

Список сегментов контактов. Когда использовать: выберите идентификатор сегмента для create_broadcast или list_contacts(segment_id=…). Возвращает: { segments: [...] } - массив сформированных сегментов с contactCount. Пример: { per_page: 50 }

Список встраиваемых форм регистрации. Когда использовать: чтобы найти существующие формы перед созданием дубликата. У каждой формы есть publicId — его можно использовать во встраиваемом фрагменте. Возвращает: { items[], meta } — постраничный список форм с именем, флагом активности, количеством отправок. Пример: { per_page: 50 }

Перечислить все темы подписки, определенные для этой учетной записи. Когда использовать: выбрать topic_id для рассылки или проверить, какие настройки существуют. Возвращает: в формате { items: [topic, ...] }. Пример: {}

Перечислить заблокированные email-адреса (не будут получать письма). Когда использовать: проверить, какие адреса заблокированы, или пролистать список, чтобы найти конкретную запись. Возвращает: { items[], meta } - постраничный список блокировок с причиной и createdAt. Пример: { per_page: 100 }

Список шаблонов писем. Когда использовать: выбрать идентификатор шаблона для send_email или render_template, или проверить, какие шаблоны существуют. Возвращает: { items[], meta } — шаблоны с пагинацией, содержащие name, version, published. Пример: { per_page: 50 }

Список настроенных конечных точек вебхуков. Когда использовать: проверять, какие интеграции получают события. Возвращает: { webhooks: [...] } - массив структурированных вебхуков. Пример: { per_page: 50 }

Перечислите все workflows (автоматизированные пайплайны, запускаемые по событиям), определённые для этой команды. Когда использовать: найти существующие автоматизации перед созданием новой, или провести аудит того, что сейчас активно. Возвращает: { items: [workflow, ...] } - каждый workflow содержит publicId, name, triggerType, status (черновик/активен/приостановлен). Пример: {}

Приостанавливает активный workflow, чтобы НОВЫЕ события триггера НЕ запускали выполнение. Текущие выполнения продолжаются до завершения. Когда использовать: временная остановка автоматизации без её удаления. Возвращает: workflow со статусом "paused". Пример: { id: "wf_abc123" }

Рендеринг, линтинг и измерение письма за один раз БЕЗ отправки. Когда использовать: ДО send_email, если тело письма сгенерировано агентом. Объединяет render_template (если указан template_id), проверку на спам, предупреждения о доставляемости и измерение размера, так что вам понадобится всего один запрос, чтобы узнать, можно ли безопасно отправлять. Возвращает: { rendered_subject, rendered_html, rendered_text, size: { html_bytes, text_bytes }, spam: { score, action, symbols[], skipped }, warnings: [{ severity, code, message }] }. Пример: { from: "Acme <hi@acme.io>", to: ["a@b.io"], template_id: "tpl_welcome", variables: { first_name: "Ada" } }

Отмечает шаблон как опубликованный, чтобы на него можно было ссылаться из send_email. Когда использовать: после создания или редактирования шаблона, который вы проверили и хотите сделать доступным для отправки. Возвращает: оформленный шаблон с published=true. Пример: { id: "tpl_abc" }

Удаляет один контакт из сегмента. Когда использовать: точечное удаление (например, отказ от рассылки, ручное исключение). Контакт не удаляется. Возвращает: { success: boolean }. Пример: { id: "seg_abc", contact_id: "con_1" }

Удалить адрес из списка подавления (отправка возобновится). Когда использовать: ранее заблокированный пользователь явно дал повторное согласие (opt-in), или возврат письма был вызван неправильной конфигурацией. Возвращает: { success: boolean }. Пример: { email: "fixed@aol.com" }

Удаляет узел и все связанные с ним рёбра. Сначала подтвердите с пользователем. Когда использовать: при удалении узла из автоматизации. Триггерный узел нельзя удалить; удаление узла может отключить нижестоящие узлы — переподключите их по необходимости. Возвращает: { success: boolean }. Пример: { id: "wf_abc123", node_id: "wfn_x" }

Выполняет серверный рендеринг шаблона с переданными переменными. Когда использовать: агент хочет предварительно просмотреть итоговый subject/html/text перед отправкой или проверить, какие переменные ожидает шаблон. Возвращает missing_variables[], чтобы агент мог запросить недостающие переменные у пользователя или подставить значения по умолчанию. Возвращает: { subject, html, text, missing_variables[], template_variables[] }. Пример: { template_id: "tpl_welcome", variables: { first_name: "Ada" } }

Повторно доставьте одну прошлую доставку вебхука (например, ту, что не удалась из-за недоступности конечной точки). Когда использовать: после исправления конечной точки повторите пропущенные доставки, найденные с помощью get_webhook_deliveries. Возвращает: { success: boolean }. Пример: { id: 17, delivery_id: 9001 }

Отправить ответ на входящее письмо (тема и заголовки цепочки писем устанавливаются автоматически). Когда использовать: агент подготовил текст ответа и хочет отправить его. При необходимости процитируйте исходное сообщение в теле письма. Возвращает: { id } нового исходящего письма. Пример: { id: 7, from: "support@acme.io", html: "<p>Thanks for reaching out…</p>" }

Перенесите запланированное письмо на новое время отправки. Когда использовать: нужно изменить время доставки письма в очереди (например, отправить раньше или позже в рамках рабочего дня). Возвращает: { success: boolean }. Пример: { id: "em_7kf2x9", scheduled_at: "2026-04-18T09:00:00Z" }

Повторно отправляет уже разосланную рассылку той части подписчиков, которые не открыли или не кликнули — создаётся новая рассылка, нацеленная на автоматически собранный сегмент этих получателей. Когда использовать: повысить вовлечённость по уже отправленной рассылке (например, второй контакт с теми, кто не открыл, но с новой темой письма). Исходная рассылка уже должна быть отправлена. Возвращает: { broadcast: { id, subject, status }, segment: { id, name }, recipientCount }. Пример: { id: "br_abc", target: "non_openers", subject: "Did you miss this?" }

Навсегда отозвать API-ключ - все последующие запросы с его использованием будут отклоняться. Когда использовать: ключ был скомпрометирован или больше не нужен. Подтвердите с пользователем - необратимо. Возвращает: { success: boolean }. Пример: { id: 17 }

Ротация ключа API: выпустить новый секрет и аннулировать старый. Полный новый ключ возвращается ОДИН РАЗ в этом ответе и не может быть получен снова. Когда использовать: ключ мог быть скомпрометирован, или вы проводите плановую ротацию. Идентификатор ключа не меняется; меняется только секрет — запросы с использованием старого секрета немедленно отклоняются. Возвращает: сформированный ключ, включающий новую секретную строку — отобразите его один раз и сообщите пользователю обновить свою интеграцию. Пример: { id: 17 }

Обновляет секрет подписи вебхука. Новый секрет возвращается ОДИН раз; события, отправленные после этого вызова, подписываются им. Когда использовать: секрет подписи может быть скомпрометирован, или при плановой ротации. Немедленно обновите проверку на вашем эндпоинте. Возвращает: сформированный вебхук плюс новый signingSecret (показан один раз). Пример: { id: 17 }

Ищет контакты с фильтрами (сегмент, вовлеченность, отписки) и нечётким запросом по email/first_name/last_name. Добавляет match_reason в каждую строку, указывая, какое поле совпало с запросом. Когда использовать: агенту нужно найти набор кандидатов, например «активные контакты в @acme.io», «все неактивные контакты», «люди по имени Сара». Используйте list_contacts для обычной пагинации без запроса, или используйте этот инструмент, когда нужна фильтрация или аннотация совпадений по строкам. Возвращает: { items: [shaped contact + match_reason], meta: { page, perPage, total, totalPages } }. Пример: { query: "ada", filters: { engagement_segment: "active" }, limit: 25 }

Отправляет несколько писем в одном пакетном запросе (до 100 за вызов). Когда использовать: агенту нужно отправить одинаковое или разное содержимое многим получателям за один цикл. Для рассылок по сохранённому сегменту используйте вместо этого create_broadcast/send_broadcast. Возвращает: { data: [{ id }, ...] } - один id на каждое письмо в порядке отправки. Пример: { emails: [{ from, to: ["a@x"], subject: "hi", html }] }

Отправить черновую рассылку в её сегмент немедленно. Когда использовать: после того как пользователь проверил подготовленную рассылку и одобрил отправку. Рассылка должна быть в статусе «draft». Возвращает: { success: boolean }. Пример: { id: "br_abc" }

Отправить одно транзакционное письмо сразу или запланировать его на будущее время. Когда использовать: агент решил, что отправить (тема + html/текст + получатели) и хочет, чтобы PostStack доставил письмо. Сначала запустите preview_email и lint_email, если содержимое было сгенерировано агентом. Возвращает: { id } - идентификатор нового письма, подходящий для get_email или cancel_email. Пример: { from: "Ada <ada@example.com>", to: ["new@user.io"], subject: "Welcome", html: "<p>Hi</p>" }

Включить контакт в подписку на тему. Когда использовать: явное согласие пользователя («подпишите меня на обновления продуктов»). Возвращает: сформированную запись подписки. Пример: { contact_id: "con_abc", topic_id: "top_abc" }

Подбирает подходящие адреса отправителя для заданной цели, используя проверенные домены команды и существующие почтовые ящики. Когда использовать: агент не знает, какой адрес отправителя применить. Передайте цель ("transactional", "marketing", "support", "newsletter" и т.д.); инструмент ранжирует варианты на основе существующих почтовых ящиков (реальных входящих) и типовых локальных частей для этой цели. Возвращает: { recommended: string|null, alternatives: string[], reasoning: string }. Пример: { purpose: "transactional" }

Отправляет тестовое событие на URL вебхука, чтобы проверить, доступен ли он и проходит ли проверка подписи. Когда использовать: после создания или редактирования вебхука — убедиться, что конечная точка принимает доставки. Возвращает: { success: boolean }. Пример: { id: 17 }

Вручную запускает рабочий процесс для конкретного контакта. Работает с любым trigger_type, но полезнее всего для "manual" рабочих процессов. Когда использовать: для проверки нового пайплайна от начала до конца или для запуска разового онбординга для одного контакта. Возвращает: { success: boolean } — запуск поставлен в очередь; проверьте ленту активности контакта для получения результатов. Пример: { id: "wf_abc123", contact_id: "con_abc123" }

Помечает шаблон как неопубликованный, чтобы его нельзя было отправить. Когда использовать: скрыть шаблон из отправки без удаления (например, завершить кампанию, сохранив историю). Возвращает: сформированный шаблон с published=false. Пример: { id: "tpl_abc" }

Помечает контакт как отписанный от всех писем (запись контакта сохраняется). Когда использовать: обрабатывать запрос на отписку, полученный вне PostStack (например, тикет в поддержку, настройки приложения). Возвращает: { success: boolean }. Пример: { id: "con_abc123" }

Отпишите контакт от темы подписки. Когда использовать: явный отказ пользователя от одной настройки (контакт остаётся в других темах и в глобальном списке). Возвращает: { success: boolean }. Пример: { contact_id: "con_abc", topic_id: "top_abc" }

Редактировать черновик рассылки на месте. Только черновики рассылок можно обновлять. Когда использовать: доработать тему/тело/сегмент перед отправкой или до запланированного времени. Возвращает: сформированную рассылку, отражающую новое состояние. Пример: { id: "br_abc", subject: "April update (revised)" }

Обновить имя, свойства или статус подписки существующего контакта. Когда использовать: чтобы синхронизировать запись контакта с вашим приложением (смена имени, обновление тарифа, отказ от подписки). Возвращает: обновлённый контакт, отражающий новое состояние. Пример: { id: "con_abc123", properties: { plan: "scale" } }

Редактировать метку, опции или флаг обязательности пользовательского свойства контакта. Когда использовать: переименовать метку, расширить список вариантов для выпадающего списка или переключить флаг обязательности. Нельзя изменить тип после создания. Возвращает: структурированное свойство. Пример: { id: 5, options: ["free","pro","scale","enterprise"] }

Обновить настройки домена (трекинг, TLS, входящие, BIMI, поток отправки). Когда использовать: включение/отключение трекинга, переключение режимов TLS, включение приема входящих вебхуков и маршрутизации catch-all, установка логотипа BIMI или привязка домена к конкретному потоку отправки. Возвращает: домен с обновленными настройками. Пример: { id: 42, click_tracking: false, tls_mode: "enforced", inbound_enabled: true }

Обновляет отображаемое имя почтового ящика, квоту, статус или настройку вебхука. Когда использовать: изменить метку владельца, приостановить почтовый ящик, увеличить квоту. Возвращает: оформленный почтовый ящик с новым состоянием. Пример: { id: "mb_abc", status: "suspended" }

Переименовать существующий сегмент. Когда использовать: приводить в порядок имена сегментов. Состав участников не меняется. Возвращает: сформированный сегмент с новым именем. Пример: { id: "seg_abc", name: "Spring 2026 launch (final)" }

Обновляет поля формы регистрации, целевой сегмент/тему, сообщения или статус активности. Когда использовать: настройка формы без повторной вставки. Установите active=false, чтобы прекратить прием новых отправок, сохранив форму. Возвращает: сформированную форму с новым состоянием. Пример: { id: "sf_xyz789", active: false }

Обновить имя, тему, тело или список переменных существующего шаблона. Когда использовать: редактировать шаблон на месте. Версия шаблона увеличивается при обновлении. Возвращает: сформированный шаблон с новой версией. Пример: { id: "tpl_abc", subject: "Updated subject" }

Редактирует URL, список событий или состояние активности webhook. Когда использовать: смена конечной точки, расширение/сужение событий или временное отключение. Возвращает: настроенный webhook с новым состоянием. Пример: { id: 17, enabled: false }

Обновляет имя, тип или конфигурацию триггера рабочего процесса. Когда использовать: переименование, смена триггера или уточнение фильтров триггера. Для редактирования графа используйте add_workflow_node, update_workflow_node, remove_workflow_node и connect_workflow_nodes. Возвращает: сформированный рабочий процесс с новым состоянием. Пример: { id: "wf_abc123", name: "Renamed onboarding" }

Заменяет конфиг узла. Нельзя изменить его тип или связи (используйте connect_workflow_nodes / remove_workflow_node). Когда использовать: подправить ID шаблона, длительность ожидания или условие предиката без перестройки графа. Возвращает: { success: true }. Пример: { id: "wf_abc123", node_id: "wfn_x", config: { duration: 1, unit: "hours" } }

Проверяет, безопасно ли отправлять письмо на email-адрес, ПЕРЕД вызовом create_contact или send_email. Выполняет проверку синтаксиса → MX → одноразовых/ролевых адресов, возвращает результат + уровень риска. Когда использовать: пользователь только что ввёл адрес, импортируется CSV, или агент собирается добавить контакт. Дешёво, в реальном времени, без внешнего трафика кроме DNS. Возвращает: { email, result: "deliverable"|"undeliverable"|"risky"|"unknown", risk: "low"|"medium"|"high", checks: { syntax, mx, disposable, role, free } }. Пример: { email: "user@example.com" }

Проверяет до 100 email-адресов за один вызов. Те же проверки, что и validate_email для каждого адреса. Когда использовать: очистка только что импортированного списка перед массовым create_contact, или предварительная проверка сегмента рассылки. Возвращает: { results: [{ email, result, risk, checks: { syntax, mx, disposable, role, free } }, ...] }, та же структура, что и validate_email для каждой строки, в порядке ввода. Пример: { emails: ["a@example.com", "b@example.com"] }

Запускает DNS-проверку для домена. Когда использовать: пользователь настроил DNS-записи (SPF/DKIM/DMARC/return-path) и хочет, чтобы PostStack перепроверил их. Возвращает новый статус - "verified" означает, что отправка разблокирована. Возвращает: оформленный домен с обновлённым статусом и флагами проверки для каждой записи. Пример: { id: 42 }