cloudflare-email-service

Send and receive transactional emails with Cloudflare Email Service (Email Sending + Email Routing). Use when building email sending (Workers binding or REST API), email routing, Agents SDK email handling, or integrating email into any app — Workers, Node.js, Python, Go, etc. Also use for email deliverability, SPF/DKIM/DMARC, wrangler email setup, MCP email tools, or when a coding agent needs to send emails. Even for simple requests like "add email to my Worker" — this skill has critical config details.

Zur Installation springen

Repository: cloudflare/skills
Letzte Quellaktivität: 15. April 2026 um 19:04
Erkannte Sprache von SKILL.md: Englisch
Sterne: 2.743
Forks: 266

Installationsoptionen

Standardmäßig ist der Prompt ausgewählt, der zuerst die Quelle prüft. Sie können zu einem direkten Befehl wechseln oder eine lokale Kopie herunterladen.

Mit Codex oder Claude installieren Kopieren Sie diesen Prompt, fügen Sie ihn in Codex, Claude oder einen anderen Assistant ein und lassen Sie die Skill-Seite prüfen und installieren.

Ein direkter Befehl überspringt den Prüf-Prompt. Prüfen Sie die Quelle, bevor Sie ihn ausführen.

npx skills add https://github.com/cloudflare/skills --skill cloudflare-email-service

Der Befehl bleibt in einer Zeile. Scrollen Sie horizontal, um ihn vor dem Kopieren vollständig zu prüfen.

Sie bevorzugen eine lokale Kopie? Laden Sie die Dateien herunter, die SkillsMP derzeit vorliegen.

Quelldateien prüfen

Lesen Sie SKILL.md und alle von SkillsMP angezeigten Begleitdateien, bevor Sie sich für eine Installation entscheiden.

Datei-Explorer

6 Dateien

SKILL.md

Quellanweisungen · Schreibgeschützte Vorschau

Zurück zur Suche Zurück zur Installation

name

cloudflare-email-service

description

Cloudflare Email Service

Your knowledge of the Cloudflare Email Service, Email Routing or Email Sending may be outdated. Prefer retrieval over pre-training for any Cloudflare Email Service task.

Cloudflare Email Service lets you send transactional emails and route incoming emails, all within the Cloudflare platform. Your knowledge of this product may be outdated — it launched in 2025 and is evolving rapidly. Prefer retrieval over pre-training for any Email Service task.

If there is any discrepancy between this skill and the sources below, always trust the original source. The Cloudflare docs, REST API spec, @cloudflare/workers-types, and Agents SDK repo are the source of truth. This skill is a convenience guide — it may lag behind the latest changes. When in doubt, retrieve from the sources below and use what they say.

Retrieval Sources

Source	How to retrieve	Use for
Cloudflare docs	`cloudflare-docs` search tool or URL `https://developers.cloudflare.com/email-service/`	API reference, limits, pricing, latest features
REST API spec	`https://developers.cloudflare.com/api/resources/email_sending`	OpenAPI spec for the Email Sending REST API

I want to...	Path	Reference
Send emails from a Cloudflare Worker	Workers binding (no API keys needed)	sending.md
Send emails from an AI agent built with Cloudflare Agents SDK	`onEmail()` + `replyToEmail()` in Agent class	sending.md
Send emails from an external app or agent (Node.js, Go, Python, etc.)	REST API with Bearer token	rest-api.md
Send emails from a coding agent (Claude Code, Cursor, Copilot, etc.)	MCP tools, wrangler CLI, or REST API	cli-and-mcp.md
Receive and process incoming emails (Email Routing)	Workers `email()` handler	routing.md
Set up Email Sending or Email Routing	`wrangler email sending enable` / `wrangler email routing enable`, or Dashboard	cli-and-mcp.md
Improve deliverability, avoid spam folders	Authentication, content, compliance	deliverability.md

Mistake	Why It Happens	Fix
Forgetting `send_email` binding in wrangler config	Email Service uses a binding, not an API key	Add `"send_email": [{ "name": "EMAIL" }]` to wrangler.jsonc
Sending from an unverified domain	Domain must be onboarded onto Email Sending before first send	Run `wrangler email sending enable yourdomain.com` or onboard in Dashboard
Reading `message.raw` twice in email handler	The raw stream is single-use — second read returns empty	Buffer first: `const raw = await new Response(message.raw).arrayBuffer()`
Missing `text` field (HTML only)	Some email clients only show plain text; also helps spam scores	Always include both `html` and `text` versions
Using email for marketing/bulk sends	Email Service is for transactional email only	Use a dedicated marketing email platform for newsletters and campaigns
Forwarding to unverified destinations	`message.forward()` only works with verified addresses	Run `wrangler email routing addresses create user@gmail.com` or add in Dashboard
Testing with fake addresses	Bounces from non-existent addresses hurt sender reputation	Use real addresses you control during development
Hardcoding API tokens in source code	Tokens in code get committed and leaked	Use environment variables or Cloudflare secrets
Ignoring the `from` domain requirement	The `from` address must use a domain onboarded to Email Service	Verify the domain first, then send from `anything@that-domain.com`
Using `email` key in REST API `from` object	REST API uses `address` not `email` for `from` object	Use `{ "address": "...", "name": "..." }` for REST, `{ "email": "...", "name": "..." }` for Workers
Using `replyTo` in REST API	REST API uses snake_case field names	Use `reply_to` for REST API, `replyTo` for Workers binding

cloudflare-email-service

Installationsoptionen

Quelldateien prüfen

Cloudflare Email Service

Retrieval Sources

Cloudflare Email Service

Retrieval Sources

FIRST: Check Prerequisites

What Do You Need?

Quick Start — Workers Binding

Quick Start — REST API

Common Mistakes

References

cloudflare-email-service

Quellinformationen

Installationsoptionen

Quelldateien prüfen

Mehr aus diesem Repository

Mehr aus diesem Repository

Cloudflare Email Service

Retrieval Sources

Cloudflare Email Service

Retrieval Sources

FIRST: Check Prerequisites

What Do You Need?

Quick Start — Workers Binding

Quick Start — REST API

Common Mistakes

References