事件订阅允许您在 Cloudflare 账户中发生事件时接收消息。Cloudflare 产品（例如 KV、Workers AI、Workers）可以将结构化事件发布到队列，然后您可以使用 Workers 或 HTTP 拉取消费者来消费这些事件，以构建自定义工作流、集成或逻辑。
Email Sending 事件订阅会发布从已启用发送域发送的出站事务性电子邮件生命周期事件。每个订阅限定于一个发送域：zone 顶点（例如 example.com）或已验证的发送子域（例如 send.example.com）。
Email Routing 事件（包括入站转发、回复、Worker 发出的路由事件以及投递到已验证路由收件人的事件）不会作为 Email Sending 事件发布。
在收件人邮件服务器接受消息时触发。
示例：
{
"type": "cf.email.sending.message.delivered",
"source": {
"type": "email.sending",
"zoneId": "023e105f4ecef8ad9ca31a8372d0c353",
"domain": "example.com"
},
"payload": {
"eventId": "0190d0c4-7e9a-7b3c-9f12-1a2b3c4d5e6f",
"messageId": "0101018f7d0c4d9a-msg-deadbeef",
"sender": "[email protected]",
"recipient": "[email protected]",
"subject": "Welcome",
"terminal": true,
"delivery": {
"status": "delivered",
"provider": "gmail",
"deliveryTimeMs": 1234,
"smtpStatusCode": "250",
"smtpEnhancedStatusCode": "2.0.0",
"smtpResponse": "250 2.0.0 OK 1714820445 a1b2c3 - gsmtp"
}
},
"metadata": {
"accountId": "f9f79265f388666de8122cfb508d7776",
"eventSubscriptionId": "1830c4bb612e43c3af7f4cada31fbf3f",
"eventSchemaVersion": 1,
"eventTimestamp": "2026-06-01T02:48:57.132Z"
}
}在发生临时投递失败且投递重试仍在等待中时触发。
示例：
{
"type": "cf.email.sending.message.deferred",
"source": {
"type": "email.sending",
"zoneId": "023e105f4ecef8ad9ca31a8372d0c353",
"domain": "send.example.com"
},
"payload": {
"eventId": "0190d0c4-7e9b-7714-9004-11f0b6d9a341",
"messageId": "0101018f7d0c4d9a-msg-deferred",
"sender": "[email protected]",
"recipient": "[email protected]",
"subject": "Your receipt",
"terminal": false,
"delivery": {
"status": "deferred",
"provider": "external_smtp",
"deliveryTimeMs": 2143,
"smtpStatusCode": "451",
"smtpEnhancedStatusCode": "4.2.0",
"smtpResponse": "451 4.2.0 Temporary mailbox error"
},
"bounce": {
"type": "soft",
"classification": "temporary_failure",
"reason": "451 4.2.0 Temporary mailbox error"
}
},
"metadata": {
"accountId": "f9f79265f388666de8122cfb508d7776",
"eventSubscriptionId": "1830c4bb612e43c3af7f4cada31fbf3f",
"eventSchemaVersion": 1,
"eventTimestamp": "2026-06-01T02:48:57.132Z"
}
}在发生永久退信，或临时投递重试已耗尽时触发。
示例：
{
"type": "cf.email.sending.message.bounced",
"source": {
"type": "email.sending",
"zoneId": "023e105f4ecef8ad9ca31a8372d0c353",
"domain": "send.example.com"
},
"payload": {
"eventId": "0190d0c4-7ea1-7af2-8b88-c1d2e3f4a5b6",
"messageId": "0101018f7d0c4d9a-msg-bounced",
"sender": "[email protected]",
"recipient": "[email protected]",
"subject": "Your receipt",
"terminal": true,
"delivery": {
"status": "bounced",
"provider": "external_smtp",
"deliveryTimeMs": 2143,
"smtpStatusCode": "550",
"smtpEnhancedStatusCode": "5.1.1",
"smtpResponse": "550 5.1.1 User unknown"
},
"bounce": {
"type": "hard",
"classification": "permanent_failure",
"reason": "550 5.1.1 User unknown"
}
},
"metadata": {
"accountId": "f9f79265f388666de8122cfb508d7776",
"eventSubscriptionId": "1830c4bb612e43c3af7f4cada31fbf3f",
"eventSchemaVersion": 1,
"eventTimestamp": "2026-06-01T02:48:57.132Z"
}
}在发生内部或非 SMTP 投递错误时触发。
示例：
{
"type": "cf.email.sending.message.failed",
"source": {
"type": "email.sending",
"zoneId": "023e105f4ecef8ad9ca31a8372d0c353",
"domain": "example.com"
},
"payload": {
"eventId": "0190d0c4-81c1-7bc6-9344-829cd9001a12",
"messageId": "0101018f7d0c4d9a-msg-failed",
"sender": "[email protected]",
"recipient": "[email protected]",
"subject": "Welcome",
"terminal": true,
"delivery": {
"status": "failed"
},
"failure": {
"reason": "delivery_failed"
}
},
"metadata": {
"accountId": "f9f79265f388666de8122cfb508d7776",
"eventSubscriptionId": "1830c4bb612e43c3af7f4cada31fbf3f",
"eventSchemaVersion": 1,
"eventTimestamp": "2026-06-01T02:48:57.132Z"
}
}在消息因策略（包括抑制、验证拒绝或垃圾邮件拒绝）而在投递前被拒绝时触发。
示例：
{
"type": "cf.email.sending.message.rejected",
"source": {
"type": "email.sending",
"zoneId": "023e105f4ecef8ad9ca31a8372d0c353",
"domain": "example.com"
},
"payload": {
"eventId": "0190d0c4-830a-77e5-8fa0-8d10f4e8dc8b",
"messageId": "0101018f7d0c4d9a-msg-rejected",
"sender": "[email protected]",
"recipient": "[email protected]",
"subject": "Welcome",
"terminal": true,
"delivery": {
"status": "rejected"
},
"rejection": {
"reason": "suppressed",
"party": "recipient",
"detail": "Recipient is suppressed"
}
},
"metadata": {
"accountId": "f9f79265f388666de8122cfb508d7776",
"eventSubscriptionId": "1830c4bb612e43c3af7f4cada31fbf3f",
"eventSchemaVersion": 1,
"eventTimestamp": "2026-06-01T02:48:57.132Z"
}
}在已投递的消息通过反馈循环被收件人标记为垃圾邮件时触发。
示例：
{
"type": "cf.email.sending.message.complained",
"source": {
"type": "email.sending",
"zoneId": "023e105f4ecef8ad9ca31a8372d0c353",
"domain": "send.example.com"
},
"payload": {
"eventId": "0190d0c4-9f01-7c44-b2a1-aabbccddeeff",
"messageId": "0101018f7d0c4d9a-msg-complained",
"sender": "[email protected]",
"recipient": "[email protected]",
"terminal": true,
"delivery": {
"status": "complained"
},
"complaint": {
"type": "abuse"
}
},
"metadata": {
"accountId": "f9f79265f388666de8122cfb508d7776",
"eventSubscriptionId": "1830c4bb612e43c3af7f4cada31fbf3f",
"eventSchemaVersion": 1,
"eventTimestamp": "2026-06-01T02:48:57.132Z"
}
}