Email Service, Queues - Subscribe to Email Sending events with Queues

<p>You can now subscribe to <strong><a href="https://developers.cloudflare.com/email-service/api/send-emails/">Email Sending</a> events</strong> through <a href="https://developers.cloudflare.com/queues/event-subscriptions/">Queues event subscriptions</a> and receive outbound transactional email lifecycle events on a queue. Each subscription is scoped to one sending domain — either the zone apex, such as <code>example.com</code>, or a verified sending subdomain, such as <code>send.example.com</code>.</p> <p>Six event types are published: <code>message.delivered</code>, <code>message.deferred</code>, <code>message.bounced</code>, <code>message.failed</code>, <code>message.rejected</code>, and <code>message.complained</code>. Use them to track deliverability, react to bounces and complaints, and drive suppression or retry logic. Email Routing events are not published on this source.</p> <p>Each event includes the message details, delivery status, and SMTP response:</p> <figure class="nb-code-figure" data-nb-lang="json"><pre class="astro-code astro-code-themes github-light github-dark nb-shiki-c6xiwz" tabindex="0" data-language="json" data-nb-lang="json"><code><span class="line"><span class="nb-shiki-140thh">{</span></span> <span class="line"><span class="nb-shiki-dzsirb"> "type"</span><span class="nb-shiki-140thh">: </span><span class="nb-shiki-mdbnqw">"cf.email.sending.message.delivered"</span><span class="nb-shiki-140thh">,</span></span> <span class="line"><span class="nb-shiki-dzsirb"> "source"</span><span class="nb-shiki-140thh">: {</span></span> <span class="line"><span class="nb-shiki-dzsirb"> "type"</span><span class="nb-shiki-140thh">: </span><span class="nb-shiki-mdbnqw">"email.sending"</span><span class="nb-shiki-140thh">,</span></span> <span class="line"><span class="nb-shiki-dzsirb"> "zoneId"</span><span class="nb-shiki-140thh">: </span><span class="nb-shiki-mdbnqw">"023e105f4ecef8ad9ca31a8372d0c353"</span><span class="nb-shiki-140thh">,</span></span> <span class="line"><span class="nb-shiki-dzsirb"> "domain"</span><span class="nb-shiki-140thh">: </span><span class="nb-shiki-mdbnqw">"example.com"</span></span> <span class="line"><span class="nb-shiki-140thh"> },</span></span> <span class="line"><span class="nb-shiki-dzsirb"> "payload"</span><span class="nb-shiki-140thh">: {</span></span> <span class="line"><span class="nb-shiki-dzsirb"> "messageId"</span><span class="nb-shiki-140thh">: </span><span class="nb-shiki-mdbnqw">"0101018f7d0c4d9a-msg-deadbeef"</span><span class="nb-shiki-140thh">,</span></span> <span class="line"><span class="nb-shiki-dzsirb"> "recipient"</span><span class="nb-shiki-140thh">: </span><span class="nb-shiki-mdbnqw">"user@example.net"</span><span class="nb-shiki-140thh">,</span></span> <span class="line"><span class="nb-shiki-dzsirb"> "terminal"</span><span class="nb-shiki-140thh">: </span><span class="nb-shiki-dzsirb">true</span><span class="nb-shiki-140thh">,</span></span> <span class="line"><span class="nb-shiki-dzsirb"> "delivery"</span><span class="nb-shiki-140thh">: {</span></span> <span class="line"><span class="nb-shiki-dzsirb"> "status"</span><span class="nb-shiki-140thh">: </span><span class="nb-shiki-mdbnqw">"delivered"</span><span class="nb-shiki-140thh">,</span></span> <span class="line"><span class="nb-shiki-dzsirb"> "smtpStatusCode"</span><span class="nb-shiki-140thh">: </span><span class="nb-shiki-mdbnqw">"250"</span></span> <span class="line"><span class="nb-shiki-140thh"> }</span></span> <span class="line"><span class="nb-shiki-140thh"> }</span></span> <span class="line"><span class="nb-shiki-140thh">}</span></span></code></pre></figure> <p>Refer to <a href="https://developers.cloudflare.com/email-service/platform/event-subscriptions/">Event subscriptions</a> to see all event types and example payloads.</p>