知识库

Zinn® Campaigns API 和 MCP：开发者指南

您在控制面板上可以在 Zinn® Campaigns 中执行的所有操作，均可通过 API 完成，并且大部分操作都可以通过基于 MCP 连接到您账户的 AI 助手来完成。本指南涵盖登录、权限、两种方式的操作示例、限制、错误以及全部 89 项 Campaigns 操作。下方的操作列表生成自我们的 API 规范，因此它始终与 API 的实际功能保持一致。每项操作的每个字段均可在 API 参考文档中找到： zinndigital.com/developers/api/zinn-campaigns。

API 密钥。 在仪表板的“设置”→“API 密钥”下创建密钥，并将其作为 Authorization: Bearer zdk_live_… 发送（zdk_test_… 密钥可在沙盒模式下使用）。仅向该密钥授予其所需的 Campaigns 权限，切勿多予。
AI 助手 (MCP)。 将 Claude、ChatGPT、Cursor 或任何 MCP 客户端连接至 https://api.zinndigital.com/v1/mcp，可通过从应用程序登录或使用连接令牌 (zmcp_live_…)。请参阅将 Claude、Cursor 或 ChatGPT 连接到您的账户。在许可屏幕上，勾选 Zinn® Campaigns 权限。
权限。 email_marketing.view 用于读取营销活动、列表、联系人、表单、发件人、 SMS 设置和报告；email_marketing.manage 用于创建和更改它们。您通过自己的电子邮件服务发送的营销活动使用 campaigns.view 和 campaigns.manage。
分销商。 传递 org_id 以对您的某个客户组织执行操作。当您的密钥或连接仅涉及一个组织时，可将其省略。

示例：使用 API 创建草稿营销活动

curl -X POST https://api.zinndigital.com/v1/email-marketing/campaigns \
  -H "Authorization: Bearer zdk_live_…" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Spring sale",
  "subject": "Our spring sale starts today",
  "list_id": "<list id>",
  "sender_id": "<sender id>",
  "template": "basic"
}'

响应为包含该草稿的 201。使用 POST /v1/email-marketing/campaigns/{campaign_id}/test 进行测试，使用 GET /v1/email-marketing/campaigns/{campaign_id}/lint 进行检查，并使用 POST /v1/email-marketing/campaigns/{campaign_id}/send 发送它。

示例：来自 AI 助手的同一草稿

用通俗的语言向您的助手提问，例如 “起草一封名为‘春季特惠’的 Zinn® Campaigns 邮件，主题为‘我们的春季特惠今天开始’”。在后台，它会通过 api_operations_search 查找操作，通过 api_operation_get 读取其参数，并通过 api_operation_call 执行该操作：

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "api_operation_call",
    "arguments": {
      "operation_id": "createEmailMarketingCampaign",
      "confirm": true,
      "body": {
        "name": "Spring sale",
        "subject": "Our spring sale starts today"
      }
    }
  }
}

助手不会执行的操作。 任何发送给您的收件人或消耗资金或额度的操作——发送营销活动、发送 SMS 或 WhatsApp 消息、使用 AI 积分进行撰写、注册 US 短信——都会对助手予以拒绝，因此被误解的指令绝不会传达给您的客户。助手会准备草稿；您可以在仪表板中按下发送，或自行调用 API。诸如 SMTP 密码等机密信息也绝不会经由助手传递：请在仪表板中输入它们。

限制

每位个人或每个 API 密钥每分钟 1,200 次请求，每个组织每分钟 6,000 次请求。以两者中更严格的限制为准。
每个 MCP 连接每分钟 600 次请求。
超过限制时，返回的响应为带有 Retry-After 标头的 429：请等待相应的秒数。
添加列表成员每次请求最多可处理 1,000 个地址；您的套餐联系人和电子邮件额度适用于您通过 API 执行的所有操作。

错误

每个错误都具有相同的结构：

{"error": {"code": "UNPROCESSABLE_ENTITY", "message": "…", "details": [{"field": "subject", "code": "REQUIRED", "message": "…"}], "request_id": "…"}}

code 针对同一个问题永不改变，因此请测试它而不是 message。联系支持团队时，请提供 request_id。您会遇到的响应：401 UNAUTHORIZED、403 FORBIDDEN、404 NOT_FOUND、409 CONFLICT、422 UNPROCESSABLE_ENTITY、429 TOO_MANY_REQUESTS。403 表示密钥或连接缺少下方列表指定的权限；404 也涵盖您在组织中看不到的内容；422 会在 details 中列出每个错误的字段；在遇到 429 后，请等待 Retry-After 标头中指定的秒数。

Webhook

投递结果从发送您电子邮件的提供商进入 Zinn® Campaigns：

使用您自己的提供商（例如 Resend）时，请在仪表盘（活动 → 发送）中的发送连接上存储其 Webhook 签名机密。您将获得一个 webhook_url；将提供商的已投递、退信和投诉事件指向它。退信或垃圾邮件投诉会立即从未来的发送中移除该地址。
使用 Zinn® 发送时，无需进行任何设置。

通过报告操作（getEmailMarketingCampaignReport、getSmsMarketingCampaignReport）读取结果。

所有 Campaigns 操作

概览

GET /v1/email-marketing — 针对单个组织的 Zinn® Campaigns 概览。操作 getEmailMarketingOverview。已检查的权限：email_marketing.view。来自 AI 助手：是，通过 MCP。

电子邮件活动

GET /v1/email-marketing/campaigns — 电子邮件活动，最新的排在最前，单页键集。操作 listEmailMarketingCampaigns。检查的权限：email_marketing.view。来自人工智能助手：是，通过 MCP。
POST /v1/email-marketing/campaigns — 创建电子邮件活动草稿。操作 createEmailMarketingCampaign。检查的权限：email_marketing.manage、email_marketing.view。来自人工智能助手：是，通过 MCP。
GET /v1/email-marketing/campaigns/{campaign_id} — 单个电子邮件活动。操作 getEmailMarketingCampaign。检查的权限：email_marketing.view。来自人工智能助手：是，通过 MCP。
PATCH /v1/email-marketing/campaigns/{campaign_id} — 编辑草稿（或被拒绝的活动，其将恢复为草稿）。操作 updateEmailMarketingCampaign。检查的权限：email_marketing.manage、email_marketing.view。来自人工智能助手：是，通过 MCP。
GET /v1/email-marketing/campaigns/{campaign_id}/lint — 在发送前检查活动文案是否存在送达率问题。操作 lintEmailMarketingCampaign。检查的权限：email_marketing.view。来自人工智能助手：是，通过 MCP。
GET /v1/email-marketing/campaigns/{campaign_id}/report — 活动数据统计。操作 getEmailMarketingCampaignReport。检查的权限：email_marketing.view。来自人工智能助手：是，通过 MCP。
POST /v1/email-marketing/campaigns/{campaign_id}/send — 开始向活动列表发送营销活动。操作 sendEmailMarketingCampaign。检查的权限：email_marketing.manage、email_marketing.view。来自 AI 助手：仅限 API 和仪表盘：由于会消耗费用或额度，因此需由人工点击（发送给真实收件人并消耗额度）。
POST /v1/email-marketing/campaigns/{campaign_id}/test — 立即向组织成员发送一份测试副本。操作 testEmailMarketingCampaign。检查的权限：email_marketing.manage、email_marketing.view。来自 AI 助手：是，通过 MCP。
POST /v1/email-marketing/campaigns/{campaign_id}/translate — 将营销活动翻译为缺失或过期的每种联系人语言。操作 translateEmailMarketingCampaign。检查的权限：email_marketing.manage、email_marketing.view。来自 AI 助手：是，通过 MCP。
GET /v1/email-marketing/campaigns/{campaign_id}/translations — 营销活动列表的每种联系人语言及其翻译是否为最新状态。操作 listEmailMarketingCampaignTranslations。检查的权限：email_marketing.view。来自 AI 助手：是，通过 MCP。

借助 AI 写作

POST /v1/email-marketing/ai/write — 使用 Zinn® AI 根据简短摘要撰写营销活动草稿邮件。操作 writeEmailMarketingCampaignWithAi。已检查权限：email_marketing.manage、email_marketing.view。来自 AI 助手：仅限 API 和控制面板：其会消耗资金或额度，因此需由人工点击（AI 写作会消耗 AI 点数）。

品牌资料包

GET /v1/email-marketing/brand-kit — 组织的品牌资料包（名称、徽标、颜色、字体、语调）。操作 getEmailMarketingBrandKit。已检查权限：email_marketing.view。来自 AI 助手：是，通过 MCP。
PUT /v1/email-marketing/brand-kit — 编辑品牌资料包。操作 updateEmailMarketingBrandKit。已检查权限：email_marketing.manage、email_marketing.view。来自 AI 助手：是，通过 MCP。
POST /v1/email-marketing/brand-kit/read — 从组织网站读取品牌资料包。操作 readEmailMarketingBrandKit。已检查权限：email_marketing.manage、email_marketing.view。来自 AI 助手：是，通过 MCP。

联系人与单次消息

GET /v1/email-marketing/contacts — 组织的联系人，每次一页键集（keyset）。操作 listEmailMarketingContacts。已检查权限：email_marketing.view。来自 AI 助手：是，通过 MCP。
POST /v1/email-marketing/contacts/{contact_id}/messages — 向单个联系人发送一条短信，从 Zinn® 信用余额中扣费。操作 sendEmailMarketingMessage。已检查权限：email_marketing.manage、email_marketing.view。来自 AI 助手：仅限 API 和控制面板：由于涉及资金或额度消耗，需由人工点击操作（向联系人发送单次消息会消耗额度）。
GET /v1/email-marketing/messages — 组织发送的短信和 WhatsApp 消息，按最新顺序排列，单页键集。操作 listEmailMarketingMessages。已检查权限：email_marketing.view。来自 AI 助手：是，通过 MCP。

列表

GET /v1/email-marketing/lists — 包含已订阅/已取消订阅计数的组织邮件列表。操作 listEmailMarketingLists。已检查权限：email_marketing.view。来自 AI 助手：是，通过 MCP。
POST /v1/email-marketing/lists — 创建邮件列表（或返回具有该名称的邮件列表）。操作 createEmailMarketingList。已检查权限：email_marketing.manage、email_marketing.view。来自 AI 助手：是，通过 MCP。
POST /v1/email-marketing/lists/{list_id}/members — 按电子邮件地址向列表中添加联系人（每次请求最多 1,000 个）。操作 addEmailMarketingListMembers。已检查权限：email_marketing.manage、email_marketing.view。来自 AI 助手：是，通过 MCP。

导入

GET /v1/email-marketing/imports — 历史联系人导入，最新的排在最前，一次一页键集分页。操作 listEmailMarketingImports。已检查权限：email_marketing.view。来自 AI 助手：是，通过 MCP。
POST /v1/email-marketing/imports — 导入一批联系人及其同意证明。操作 createEmailMarketingImport。已检查权限：email_marketing.manage、email_marketing.view。来自 AI 助手：是，通过 MCP。

注册表单

GET /v1/email-marketing/forms — 注册表单（双重确认），最新优先，单页键集分页。操作 listEmailMarketingForms。已检查权限：email_marketing.view。来自 AI 助手：是，通过 MCP。
POST /v1/email-marketing/forms — 创建一个将已确认人员添加到一个列表中的注册表单。操作 createEmailMarketingForm。已检查权限：email_marketing.manage、email_marketing.view。来自 AI 助手：是，通过 MCP。
DELETE /v1/email-marketing/forms/{form_id} — 删除注册表单（已确认的人员仍保留在列表中）。操作 deleteEmailMarketingForm。已检查权限：email_marketing.manage、email_marketing.view。来自 AI 助手：是，通过 MCP。
PATCH /v1/email-marketing/forms/{form_id} — 更改注册表单（文案、列表、重定向、开启或关闭）。操作 updateEmailMarketingForm。已检查权限：email_marketing.manage、email_marketing.view。来自 AI 助手：是，通过 MCP。

发送连接

GET /v1/email-marketing/senders — 该组织的发信连接。操作 listEmailMarketingSenders。已检查权限：email_marketing.view。来自人工智能助手：是，通过 MCP。
POST /v1/email-marketing/senders — 连接营销活动发信方（Zinn® 发信，或客户自己的 SMTP 服务器）。操作 createEmailMarketingSender。已检查权限：email_marketing.manage、email_marketing.view。来自人工智能助手：仅限 API 和仪表板：其携带绝对不能落入人工智能模型的机密（请求体为 SMTP 密码）。
DELETE /v1/email-marketing/senders/{sender_id} — 移除发信连接及其保存的密码。操作 deleteEmailMarketingSender。已检查权限：email_marketing.manage、email_marketing.view。来自人工智能助手：是，通过 MCP。
POST /v1/email-marketing/senders/{sender_id}/verify — 验证发信连接是否正常工作，无需发送任何内容。操作 verifyEmailMarketingSender。已检查权限：email_marketing.manage、email_marketing.view。来自人工智能助手：是，通过 MCP。
PUT /v1/email-marketing/senders/{sender_id}/webhook — 为此连接存储您的电子邮件提供商的 Webhook 签名机密。操作 setEmailMarketingSenderWebhook。已检查权限：email_marketing.manage、email_marketing.view。来自人工智能助手：由其他系统（提供商或访问者）调用，并非由您调用（存储提供商的 Webhook 机密）。

短信与 WhatsApp

GET /v1/email-marketing/sms — SMS 屏幕所需内容 — 是否开启？、是否暂停？、额度余额及价格。操作 getEmailMarketingSms。检查的权限：email_marketing.view。来自 AI 助手：是，通过 MCP。
GET /v1/email-marketing/sms/campaigns — 批量 SMS 营销活动，最新的排在最前，一页 keyset。操作 listSmsMarketingCampaigns。检查的权限：email_marketing.view。来自 AI 助手：是，通过 MCP。
POST /v1/email-marketing/sms/campaigns — 向列表创建草稿 SMS。操作 createSmsMarketingCampaign。检查的权限：email_marketing.manage、email_marketing.view。来自 AI 助手：是，通过 MCP。
GET /v1/email-marketing/sms/campaigns/{campaign_id} — 单个批量 SMS 营销活动。操作 getSmsMarketingCampaign。检查的权限：email_marketing.view。来自 AI 助手：是，通过 MCP。
PATCH /v1/email-marketing/sms/campaigns/{campaign_id} — 编辑草稿（或被拒绝的活动，其将恢复为草稿）。操作 updateSmsMarketingCampaign。检查的权限：email_marketing.manage、email_marketing.view。来自 AI 助手：是，通过 MCP。
GET /v1/email-marketing/sms/campaigns/{campaign_id}/report — 批量 SMS 营销活动的数据。操作 getSmsMarketingCampaignReport。检查的权限：email_marketing.view。来自 AI 助手：是，通过 MCP。
POST /v1/email-marketing/sms/campaigns/{campaign_id}/send — 开始向其名单上所有同意接收短信的人员发送短信——或恢复因余额不足而暂停的活动。操作 sendSmsMarketingCampaign。检查的权限：email_marketing.manage、email_marketing.view。来自 AI 助手：仅限 API 和控制面板：这会消耗资金或额度，因此需由人工点击（发送付费短信/WhatsApp 消息）。
GET /v1/email-marketing/sms/registrations/us — 获取该组织的 US 10DLC 注册信息及单次费用。操作 getEmailMarketingUsRegistration。检查的权限：email_marketing.view。来自 AI 助手：支持，通过 MCP。
POST /v1/email-marketing/sms/registrations/us — 提交该组织的品牌与营销活动以进行 US 10DLC 注册（提交时扣费）。操作 submitEmailMarketingUsRegistration。检查的权限：email_marketing.manage、email_marketing.view。来自 AI 助手：仅限 API 和控制面板：这会消耗资金或额度，因此需由人工点击（US 10DLC 注册会产生运营商费用）。

通过您自有的电子邮件服务开展营销活动（模板、细分受众群、压制名单）

GET /v1/campaigns — 该组织的营销活动。操作 listCampaigns。来自 AI 助手：支持，通过 MCP。
POST /v1/campaigns — 根据模板和受众创建营销活动。操作 createCampaign。来自 AI 助手：支持，通过 MCP。
DELETE /v1/campaigns/esp — 断开服务商账户连接并删除其存储的密钥。操作 disconnectEsp。来自 AI 助手：仅限 API 和仪表板：其包含绝不能传输给 AI 模型的机密（会销毁存储的 ESP 密钥）。
GET /v1/campaigns/esp — 组织自有的电子邮件服务商账户。操作 getEspConnection。来自 AI 助手：是，通过 MCP。
POST /v1/campaigns/esp — 连接电子邮件服务商账户。操作 connectEsp。来自 AI 助手：仅限 API 和仪表板：其包含绝不能传输给 AI 模型的机密（请求体即为 ESP API 密钥）。
POST /v1/campaigns/esp/verify — 验证服务商账户是否正常工作并读取其已验证的域名。操作 verifyEspConnection。来自 AI 助手：仅限 API 和仪表板：其包含绝不能传输给 AI 模型的机密（会重新检查存储的 ESP 密钥）。
POST /v1/campaigns/preview — Render 带有示例值的模板。操作 previewCampaignTemplate。来自 AI 助手：是，通过 MCP。
GET /v1/campaigns/segments — 您已保存的受众分群。操作 listCampaignSegments。检查的权限：campaigns.view。来自 AI 助手：是，通过 MCP。
POST /v1/campaigns/segments — 保存新的受众分群。操作 createCampaignSegment。检查的权限：campaigns.manage。来自 AI 助手：是，通过 MCP。
GET /v1/campaigns/segments/fields — 筛选词汇、其值列表以及魔术标签。操作 getCampaignSegmentFields。检查的权限：campaigns.view。来自 AI 助手：是，通过 MCP。
POST /v1/campaigns/segments/preview — 此操作覆盖的人数、具体受众以及排除的人群。操作 previewCampaignSegment。检查的权限：campaigns.view。来自 AI 助手：是，通过 MCP。
DELETE /v1/campaigns/segments/{segmentId} — 归档受众分群。操作 archiveCampaignSegment。检查的权限：campaigns.manage。来自 AI 助手：是，通过 MCP。
GET /v1/campaigns/segments/{segmentId} — 一个已保存的受众分群。操作 getCampaignSegment。检查的权限：campaigns.view。来自 AI 助手：是，通过 MCP。
PATCH /v1/campaigns/segments/{segmentId} — 重命名受众分群或更改其筛选条件。操作 updateCampaignSegment。检查的权限：campaigns.manage。来自 AI 助手：是，通过 MCP。
GET /v1/campaigns/suppressions — 不得接收营销信息的地址。操作 listCampaignSuppressions。检查的权限：campaigns.view。来自 AI 助手：是，通过 MCP。
POST /v1/campaigns/suppressions — 将地址添加到退订/抑制列表。操作 createCampaignSuppression。检查的权限：campaigns.manage。来自 AI 助手：是，通过 MCP。
GET /v1/campaigns/tags — 营销活动编写器提供的魔法标签面板。操作 listCampaignTags。来自人工智能助手：是，通过 MCP。
GET /v1/campaigns/templates — 组织的营销活动模板。操作 listCampaignTemplates。来自人工智能助手：是，通过 MCP。
POST /v1/campaigns/templates — 创建营销活动模板。操作 createCampaignTemplate。来自人工智能助手：是，通过 MCP。
DELETE /v1/campaigns/templates/{templateId} — 归档模板并停用其翻译源。操作 archiveCampaignTemplate。来自人工智能助手：是，通过 MCP。
GET /v1/campaigns/templates/{templateId} — 单个营销活动模板。操作 getCampaignTemplate。来自人工智能助手：是，通过 MCP。
PUT /v1/campaigns/templates/{templateId} — 编辑营销活动模板。操作 updateCampaignTemplate。来自人工智能助手：是，通过 MCP。
POST /v1/campaigns/unsubscribe — 退出营销名单。无需账户。操作 unsubscribeFromCampaigns。来自人工智能助手：仅限 API 和仪表板：其携带绝对不能传递给人工智能模型的机密（需要收件人的签名退订令牌）。
DELETE /v1/campaigns/{campaignId} — 删除营销活动并停用其递送行。操作 deleteCampaign。来自人工智能助手：仅限 API 和仪表板：其需要未向人工智能连接开放的权限（删除 ESP 营销活动需要 campaigns.send）。
GET /v1/campaigns/{campaignId} — 单个营销活动及其送达报告。操作 getCampaign。来自人工智能助手：是，通过 MCP。
POST /v1/campaigns/{campaignId}/control — 暂停、恢复或取消正在运行的发送。操作 controlCampaign。来自人工智能助手：仅限 API 和仪表盘：由于会消耗费用或额度，需由人工点击（暂停/恢复实时发送）。
POST /v1/campaigns/{campaignId}/send — 启动持久发送。操作 sendCampaign。来自人工智能助手：仅限 API 和仪表盘：由于会消耗费用或额度，需由人工点击（向真实收件人发送 ESP 营销活动）。
POST /v1/campaigns/{campaignId}/test — 在营销活动实际使用的渠道上发送一条真实消息。操作 testSendCampaign。来自人工智能助手：仅限 API 和仪表盘：需要人工智能连接未被授予的权限（ESP 测试发送需要 campaigns.send）。

公开页面与传入网络钩子

GET /v1/public/email-marketing/c/{token} — 点击计数器。记录每位收件人的单次点击并重定向至原始链接。操作 emailMarketingClick。来自人工智能助手：收件人从邮件中打开的页面（点击跟踪重定向）。
GET /v1/public/email-marketing/f/{public_id} — 注册表单的托管页面（无需登录）。操作 emailMarketingFormPage。来自人工智能助手：收件人从邮件中打开的页面（公开注册表单页面）。
POST /v1/public/email-marketing/f/{public_id} — 提交注册表单（托管页面、嵌入式或 JSON）。操作 emailMarketingFormSubmit。来自 AI 助手：由另一个系统（提供商或访客）调用，而非由您调用（访客提交注册表单）。
GET /v1/public/email-marketing/fc — 双重选择加入确认页面（无需登录）。操作 emailMarketingFormConfirmPage。来自 AI 助手：您的收件人从电子邮件打开的页面（双重选择加入确认页面）。
POST /v1/public/email-marketing/fc — 确认注册（将该用户添加到列表并附带同意记录）。操作 emailMarketingFormConfirm。来自 AI 助手：由另一个系统（提供商或访客）调用，而非由您调用（访客确认双重选择加入）。
GET /v1/public/email-marketing/o/{token} — 打开跟踪图像（1x1 GIF）。每个收件人计一次打开。操作 emailMarketingOpenPixel。来自 AI 助手：您的收件人从电子邮件打开的页面（打开跟踪像素）。
GET /v1/public/email-marketing/u/{token} — 页脚退订链接（无需登录）。操作 emailMarketingUnsubscribePage。来自 AI 助手：您的收件人从电子邮件打开的页面（退订页面）。
POST /v1/public/email-marketing/u/{token} — RFC 8058 一键退订（以及页面的“停止一切”按钮）。操作 emailMarketingUnsubscribeOneClick。来自 AI 助手：由另一个系统（提供商或访客）调用，而非由您调用（RFC 8058 一键退订）。
GET /v1/public/email-marketing/warmup-u/{token} — 营销池预热邮件的退订链接（无需登录）。操作 emailMarketingWarmupUnsubscribePage。来自 AI 助手：您的收件人从电子邮件打开的页面（预热退订页面）。
POST /v1/public/email-marketing/warmup-u/{token} — 针对预热邮件的 RFC 8058 一键退订。操作 emailMarketingWarmupUnsubscribeOneClick。来自 AI 助手：由另一个系统（提供商或访客）调用，而非由您调用（预热一键退订）。
POST /v1/webhooks/campaign-events — 从电子邮件提供商处摄取已签名的投递事件。操作 receiveCampaignDeliveryWebhook。来自 AI 助手：由另一个系统（提供商或访客）调用，而非由您调用（已签名的 ESP 投递 Webhook）。
POST /v1/webhooks/campaigns/telnyx — 来自我们短信供应商的入站短信回复（STOP / START）。操作 receiveCampaignsTelnyxInbound。来自 AI 助手：由另一个系统（提供商或访客）调用，而非由您调用（已签名的 Telnyx 入站 Webhook）。
POST /v1/webhooks/email-marketing/{connection_id} — 单个发送连接的客户自备电子邮件提供商送达事件。操作 receiveEmailMarketingProviderWebhook。来自人工智能助手：由其他系统（提供商或访问者）调用，并非由您调用（已签名的发送方提供商网络钩子）。

流程

GET /v1/email-marketing/flows — 电子邮件流程（欢迎、滴灌、年度日期），单个基于键的分页。操作 listEmailMarketingFlows。检查的权限：email_marketing.view。来自人工智能助手：是，通过 MCP。
POST /v1/email-marketing/flows — 创建流程（初始状态为草稿）。操作 createEmailMarketingFlow。检查的权限：email_marketing.manage、email_marketing.view。来自人工智能助手：是，通过 MCP。
DELETE /v1/email-marketing/flows/{flow_id} — 删除流程及其登记项（已发送的运行将作为营销活动保留）。操作 deleteEmailMarketingFlow。检查的权限：email_marketing.manage、email_marketing.view。来自人工智能助手：是，通过 MCP。
GET /v1/email-marketing/flows/{flow_id} — 包含各步骤及其报告的单个流程（已登记、进行中、各步骤的运行次数和收件人）。操作 getEmailMarketingFlow。检查的权限：email_marketing.view。来自人工智能助手：是，通过 MCP。
PATCH /v1/email-marketing/flows/{flow_id} — 修改流程；若提供 steps，将替换整个序列。操作 updateEmailMarketingFlow。检查的权限：email_marketing.manage、email_marketing.view。来自人工智能助手：是，通过 MCP。
POST /v1/email-marketing/flows/{flow_id}/activate — 开启流程；仅从现在起加入列表的用户会被加入。操作 activateEmailMarketingFlow。检查的权限：email_marketing.manage、email_marketing.view。来自人工智能助手：是，通过 MCP。
POST /v1/email-marketing/flows/{flow_id}/pause — 暂停流程；到期步骤将等待，在重新开启前不会向新用户发送邮件。操作 pauseEmailMarketingFlow。检查的权限：email_marketing.manage、email_marketing.view。来自人工智能助手：是，通过 MCP。