Service Email Cloudflare

Votre connaissance du Service Email Cloudflare, Email Routing ou Email Sending peut être obsolète. Préférez la récupération à la pré-formation pour toute tâche du Service Email Cloudflare.

Le Service Email Cloudflare vous permet d'envoyer des emails transactionnels et d'acheminer les emails entrants, le tout sur la plateforme Cloudflare. Votre connaissance de ce produit peut être obsolète — il a été lancé en 2025 et évolue rapidement. Préférez la récupération à la pré-formation pour toute tâche du Service Email.

S'il y a une discordance entre cette compétence et les sources ci-dessous, faites toujours confiance à la source originale. La documentation Cloudflare, la spécification REST API, @cloudflare/workers-types, et le repo du SDK Agents sont la source de vérité. Cette compétence est un guide de commodité — elle peut accuser du retard par rapport aux derniers changements. En cas de doute, récupérez à partir des sources ci-dessous et utilisez ce qu'elles indiquent.

Sources de Récupération

D'ABORD : Vérifier les Conditions Préalables

Avant d'écrire du code email, vérifiez que les bases sont en place :

1. Domaine intégré ? Exécutez npx wrangler email sending list pour voir quels domaines ont l'envoi d'email activé. Si le domaine n'est pas listé, exécutez npx wrangler email sending enable userdomain.com ou consultez cli-and-mcp.md pour les instructions complètes de configuration.
2. Liaison configurée ? Recherchez send_email dans wrangler.jsonc (pour Workers)
3. postal-mime installé ? Exécutez npm ls postal-mime (nécessaire uniquement pour recevoir/analyser des emails)

De Quoi Avez-Vous Besoin ?

Commencez ici. Trouvez votre situation, puis suivez le lien pour les détails complets.

Démarrage Rapide — Liaison Workers

Ajoutez la liaison à wrangler.jsonc, puis appelez env.EMAIL.send(). Le domaine from doit être intégré via npx wrangler email sending enable yourdomain.com.

// wrangler.jsonc
{ "send_email": [{ "name": "EMAIL" }] }

const response = await env.EMAIL.send({
  to: "user@example.com",
  from: { email: "welcome@yourdomain.com", name: "My App" },
  subject: "Welcome!",
  html: "<h1>Welcome!</h1>",
  text: "Welcome!",
});

La liaison est recommandée pour Workers — aucune clé API nécessaire. Si un utilisateur demande spécifiquement l'API REST depuis Workers (par exemple, s'il a déjà un workflow de jeton API), cela fonctionne aussi — consultez rest-api.md.

Consultez sending.md pour l'API complète, les envois par lot, les pièces jointes, les en-têtes personnalisés, les liaisons restreintes, et l'intégration du SDK Agents.

Démarrage Rapide — API REST

Pour les applications en dehors de Workers, ou dans Workers si l'utilisateur le demande explicitement. Différences clés par rapport à la liaison Workers :

• Point d'accès : POST https://api.cloudflare.com/client/v4/accounts/{account_id}/email/sending/send
• L'objet from utilise address (pas email) : { "address": "...", "name": "..." }
• replyTo est reply_to (snake_case)
• La réponse retourne { delivered: [], permanent_bounces: [], queued: [] } (pas messageId)

Consultez rest-api.md pour les exemples curl, le format de réponse, et la gestion des erreurs.

Erreurs Courantes

Références

Lisez la référence qui correspond à votre situation. Vous n'avez pas besoin de tous les documents.

• references/sending.md — API de liaison Workers, pièces jointes, email du SDK Agents. Pour Workers ou SDK Agents.
• references/rest-api.md — Point d'accès REST, exemples curl, gestion des erreurs. Pour les applications NON sur Workers.
• references/routing.md — Gestionnaire email() entrant, transfert, réponse, analyse. Pour recevoir les emails.
• references/cli-and-mcp.md — Configuration du domaine, commandes wrangler, outils MCP. Pour la configuration initiale.
• references/deliverability.md — SPF/DKIM/DMARC, rebonds, suppressions, bonnes pratiques.