Skip to content

[Email Service] Document sending reputation status and paused accounts - #34401

Merged
neelakolkar-cf merged 1 commit into
productionfrom
dsantos/email-sending-reputation-status
Oct 21, 2026
Merged

neelakolkar-cf merged 1 commit into
productionfrom
dsantos/email-sending-reputation-status

Conversation

@DiogoSantoss

@DiogoSantoss DiogoSantoss commented Oct 16, 2026 •

Copy link
Copy Markdown
Collaborator

Summary

Explains when Cloudflare can pause Email Sending because of a poor sending reputation, and what customers can do when it happens. The reputation notification emails link to the Email deliverability page.

  • Email deliverability: a new "Sending reputation status" section:
    • Metrics and thresholds: bounce rate (2% Warning, 5% At Risk), spam rejection rate (1% / 3%), and complaint rate (0.1% / 0.2%), over a 7-day window for each sending domain. The account takes the worst status of its domains.
    • Status levels: Healthy, Warning, At Risk, and Paused. The table says whether the account can still send at each level. An account becomes eligible for a pause after it stays At Risk for the 7-day improvement period, and Cloudflare reviews it before pausing it.
    • If your account is paused: the error codes, that queued messages are not delivered, and that rejected messages are not kept. It lists the steps to restore sending, which end with contacting Support.
    • A line in the existing best-practice metrics list links to the new section.
  • Workers API: adds E_ACCOUNT_SUSPENDED to the error codes table.
  • REST API: adds 403 / 10207 / email.sending.error.email.account_suspended to the error codes table.

Documentation checklist

@cloudflare-workers-and-pages

Copy link
Copy Markdown

🚀 Deploying Preview to Cloudflare 🚀

Preview URL: https://dsantos-email-sending-reputation-status.previews.developers.cloudflare.com (commit 25a0707)

This URL reflects your latest Preview deployment

Preview Deployments by commit

Status Deployment URL Commit Updated (UTC) See this deployment's details
  • Build: Success ✅
  • Deployment: Success ✅

View logs ↗
https://bb25bfdb.previews.developers.cloudflare.com 25a0707 2026-10-16T14:02:24.852Z Visit the dashboard ↗

@DiogoSantoss
DiogoSantoss marked this pull request as ready for review October 16, 2026 14:20
@DiogoSantoss
DiogoSantoss requested review from a team, rpots and ttoino as code owners October 16, 2026 14:20
@cloudflare-docs-bot

cloudflare-docs-bot Bot commented Oct 16, 2026 •

Copy link
Copy Markdown
Contributor

AI Review

✅ Reviewed 25a0707 · 0 findings · incremental

Commands
  • /review Run a review now.
  • /full-review Review the entire PR diff.
  • /disable-auto-review Stop automatic reviews.
  • /rebase Rebase against production.

@DiogoSantoss DiogoSantoss self-assigned this Oct 16, 2026
@cloudflare cloudflare deleted a comment from github-actions Bot Oct 16, 2026
@neelakolkar-cf
neelakolkar-cf added this pull request to the merge queue Oct 21, 2026
Merged via the queue into production with commit 7b2b79e Oct 21, 2026
18 checks passed
@neelakolkar-cf
neelakolkar-cf deleted the dsantos/email-sending-reputation-status branch October 21, 2026 13:08
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants