n8n
n8n 的 MailInApp 节点可以在 MailInApp 中发生某件事时启动工作流，并让工作流添加联系人、移动商机、把联系人加入旅程以及发送事务性邮件。它们以 n8n-nodes-mailinapp 的名称发布在 npm 上。
安装
在 n8n 中前往 Settings → Community Nodes → Install，输入 n8n-nodes-mailinapp。详情请参阅 n8n 的社区节点指南。
自托管的 n8n 现在就可以安装。n8n Cloud 只提供经 n8n 验证的社区节点，而这个包尚未通过验证。它按照 n8n 的验证规则构建，n8n 批准后即可在 Cloud 上使用。
连接你的账户
- 在 MailInApp 中前往 开发者，创建一个 API 密钥。密钥以
mia_live_开头，只显示一次。 - 在 n8n 中创建一个 MailInApp API 凭据并粘贴密钥。Base URL 保持为
https://mailinapp.com。
这个密钥代表你的整个 MailInApp 账户，请像对待密码一样保管。在 MailInApp 中吊销它，也会关闭它设置的所有触发器。
MailInApp Trigger 节点
选择一个或多个事件。激活工作流时，节点会在 MailInApp 中订阅这些事件；停用时，订阅会被删除。这些订阅会显示在 开发者 → Webhook 中，标记为 n8n。
可选的是十二个账户事件：Interaction Received、Form Submitted、Contact Created、Contact Updated、Lead Turned Hot、New Lead、Meeting Booked、Meeting Cancelled、Deal Created、Deal Stage Changed、Purchase Completed 和 Journey Completed。
每次运行收到的都是 MailInApp 发出的原始事件，包含 id、type、createdAt 和 data。同一事件的每次投递 id 都相同，可以用它去重。每次投递都经过签名。节点会拒绝没有有效签名、或时间戳超过 5 分钟的请求，所以仅知道 Webhook URL 并不能启动你的工作流。
MailInApp 节点
| 资源 | 操作 |
|---|---|
| Contact | Create or Update：在联系人列表中添加或更新地址。MailInApp 会在保存时验证地址。Get：获取该地址在每个列表或某一个列表中的联系人。 |
| Contacts List | Get Many：获取列表及其字段和联系人数。 |
| Deal | Create：按邮箱为联系人创建商机。设置 Idempotency Key（例如订单号），避免重新运行时创建第二个商机。Update：把商机移到其他阶段（包括赢单和丢单），或修改标题、金额、币种。 |
Send Transactional：使用你自己的主题和 HTML 或纯文本，或带合并数据的工作室项目。发送失败会作为错误返回。suppressed 结果（地址已退信或无效）作为正常结果返回，你可以据此分支。 | |
| Journey | Enroll Contact：把联系人加入触发器为 API 调用 的旅程。Get Many：获取旅程。 |
| Pipeline | Get Many：获取管道及其阶段。 |
下拉框会列出你的列表、列表字段、旅程、管道和阶段。节点支持 n8n 的 Continue On Fail。
不提供营销邮件发送：工作流无法证明收件人已经同意。请在 MailInApp 中发送营销邮件，或把联系人加入旅程。
搭配 AI 智能体使用
MailInApp 节点可以作为 n8n AI Agent 的工具。想要更多工具，可以再用 MCP Client Tool 节点把智能体连接到 MailInApp 的 MCP 服务器：端点为 https://mailinapp.com/api/mcp，用你的 API 密钥作为 Bearer 凭据。
包内附带一个开箱即用的示例工作流（包中的 examples/ai-agent-mcp.workflow.json）。其中的智能体可以读取联系人、结果、表单回答、分群和旅程，并起草新的旅程，但没有任何发送邮件的工具。智能体创建的旅程总是以关闭状态保存，由人检查后再开启。
不使用节点
任何 n8n 工作流也可以通过通用的 Webhook 触发器（接收你在 开发者 → Webhook 中添加的 Webhook）和调用 API 的 HTTP Request 节点来使用 MailInApp。