SendHQ 开发者文档

每一步结果都清晰可见的邮件基础设施。

验证域名、发送用户预期中的邮件、接收回复、发布带类型的模板,并查看投递情况,服务商状态不做任何隐藏。

发送一封邮件
curl https://sendhq.cc/api/v1/emails \
  -H "Authorization: Bearer $SENDHQ_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: welcome-user-42" \
  -d '{"from":"Acme <hello@example.com>","to":["customer@example.net"],"subject":"Welcome","text":"Your workspace is ready."}'

选择路径

从您需要交付的任务开始。

产品指南

着眼于完整的系统,而不是孤立的某个请求。

从这里开始

快速入门

创建密钥、验证域名,并用一个可安全重试的请求发送一封受控的邮件。

从这里开始

从 Resend 迁移

将 Resend 的 HTTP 发信请求映射到 SendHQ,并在切换之前处理好兼容性边界。

Start here

Migrate from SendGrid

Move SendGrid Mail Send, dynamic templates, Event Webhook, suppressions, and Inbound Parse to the SendHQ API, with a prompt your coding agent can run.

Start here

Migrate from Mailgun

Move Mailgun Messages API sends, templates, webhooks, suppressions, and Routes to the SendHQ API, with a prompt your coding agent can run.

Start here

Migrate from Postmark

Move Postmark Email API sends, message streams, templates, webhooks, suppressions, and inbound processing to the SendHQ API, with a prompt your coding agent can run.

Start here

Migrate from Amazon SES

Move Amazon SES SendEmail calls, configuration-set events, the account suppression list, templates, and receipt rules to the SendHQ API, with a prompt your coding agent can run.

Start here

Migrate from AgentMail

Move AgentMail inboxes, sends, replies, threads, labels, and message webhooks for AI agents to SendHQ inboxes and the SendHQ API, with a prompt your coding agent can run.

Start here

Migrate from Mailtrap

Move Mailtrap Email Sending API calls, webhooks, and suppressions to the SendHQ API, with a prompt your coding agent can run.

Start here

Migrate from Brevo

Move Brevo transactional email API sends, templates, webhooks, and blocked contacts to the SendHQ API, with a prompt your coding agent can run.

Start here

Use SendHQ with ShipFast

Send ShipFast's sendEmail() and NextAuth magic-link emails through the SendHQ API instead of Resend and SMTP, with a prompt your coding agent can run.

从这里开始

身份验证

产品集成使用服务端 API 密钥,工作区管理使用浏览器会话。

从这里开始

错误与重试

解析标准的 JSON 错误封装,并判断何时可以安全重试。

从这里开始

版本管理与弃用

了解 URL 主版本、兼容性新增、弃用通知和停用窗口期。

发信

发送邮件

安全地发送事务性邮件、批量邮件、回复、附件和托管模板。

发信

域名与 DNS

Provision sender identities and interpret DNS, propagation, and repair states.

发信

托管模板

创建带类型的草稿、预览精确输出、发布不可变的版本,并保留发送溯源信息。

Send

Newsletters and campaigns

Keep consented contacts, target segments, write, test, schedule, and send broadcasts, read bot-filtered open and click reports, and publish a newsletter site.

Send

Events and connections

Tell SendHQ what your contacts do, from your own code, from a payment provider's webhook, or from a spreadsheet, and see what came in and which automations it started.

收信

入站邮件

创建收件箱、接收路由过来的邮件、留存附件,并按时间顺序构建会话。

收信

标签与分类

自动将发出和收到的邮件归入标签,并为智能体分配一个其会话永远不会离开的分类。

收信

垃圾邮件、通知类邮件与重要性

SendHQ 如何将收到的邮件分为主要、通知和垃圾邮件,如何标记重要邮件,以及如何从纠正中学习。

运维

送达率

了解服务商事件、发信身份信誉、每日爬坡和自动恢复。

运维

抑制列表与退订

防止向已退信、已投诉或已退订的收件人进行不安全的投递。

Operate

Webhooks

Receive signed email events (sent, delivered, delayed, bounced, complained, failed, received) at your own HTTPS endpoint, with retries.

运维

计费与限制

Understand the subscription requirement, the daily sending ramp, recipient credits, attachment transfer, and webhook-driven entitlements.

Tools

Command-line interface

Install the SendHQ CLI to send and read email, verify domains, manage inboxes and templates, and run the MCP server from a terminal, a script, or CI.

Integrations

Supabase Auth emails

Send Supabase sign-up, magic link, password reset, and email change messages through SendHQ with Supabase's Send Email hook and an Edge Function.

机器可读的接口约定

OpenAPI 3.1,与这些页面由同一份目录生成。

可将该规范用于客户端、测试、服务发现和智能体工具。

打开规范浏览端点