Event subscriptions（イベントサブスクリプション）を使うと、Cloudflare アカウント全体でイベントが発生したときにメッセージを受け取れます。Cloudflare の製品（例: KV、Workers AI、Workers）は、構造化されたイベントを queue へ公開できます。その後、Workers または HTTP pull consumers で消費し、カスタムワークフロー、連携、ロジックを構築できます。
Event Subscriptions の詳細は、管理ガイド を参照してください。
Email Sending のイベントサブスクリプションは、有効な送信ドメインから送られたメッセージについて、アウトバウンドのトランザクションメールのライフサイクルイベントを公開します。各サブスクリプションは 1 つの送信ドメインにスコープされます。ゾーン apex（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"
}
}