Cloudflare Deploy

interface ExportedHandler<Env = unknown> {
  email?(message: ForwardableEmailMessage, env: Env, ctx: ExecutionContext): void | Promise<void>;
}

interface ForwardableEmailMessage {
  readonly from: string;          // Envelope sender (e.g., "[email protected]")
  readonly to: string;             // Envelope recipient (e.g., "[email protected]")
  readonly headers: Headers;       // Web API Headers object
  readonly raw: ReadableStream;    // Raw MIME message stream
  
  setReject(reason: string): void;
  forward(rcptTo: string, headers?: Headers): Promise<void>;
}

// Access headers
const subject = message.headers.get("subject");
const from = message.headers.get("from");
const messageId = message.headers.get("message-id");

// Check spam score
const spamScore = parseFloat(message.headers.get("x-cf-spamh-score") || "0");
if (spamScore > 5) {
  message.setReject("Spam detected");
}

// Envelope addresses (routing, auth checks)
message.from // "[email protected]" (actual sender)
message.to   // "[email protected]" (your address)

// Header addresses (display, user-facing)
message.headers.get("from") // "Alice <[email protected]>"
message.headers.get("to")   // "Bob <[email protected]>"

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

interface Env {
  EMAIL: SendEmail;
}

interface SendEmail {
  send(message: EmailMessage): Promise<void>;
}

interface EmailMessage {
  from: string | { name?: string; email: string };
  to: string | { name?: string; email: string } | Array<string | { name?: string; email: string }>;
  subject: string;
  text?: string;
  html?: string;
  headers?: Headers;
  reply_to?: string | { name?: string; email: string };
}

interface Env {
  EMAIL: SendEmail;
}

export default {
  async fetch(request, env, ctx): Promise<Response> {
    await env.EMAIL.send({
      from: { name: "Acme Corp", email: "[email protected]" },
      to: [
        { name: "Alice", email: "[email protected]" },
        "[email protected]"
      ],
      subject: "Your order #12345 has shipped",
      text: "Track your package at: https://track.example.com/12345",
      html: "<p>Track your package at: <a href='https://track.example.com/12345'>View tracking</a></p>",
      reply_to: { name: "Support", email: "[email protected]" }
    });
    
    return new Response("Email sent");
  }
} satisfies ExportedHandler<Env>;

curl -H "Authorization: Bearer $API_TOKEN" https://api.cloudflare.com/client/v4/...

curl -X POST "https://api.cloudflare.com/client/v4/zones/$ZONE_ID/email/routing/rules" \
  -H "Authorization: Bearer $API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "enabled": true,
    "name": "Forward sales",
    "matchers": [{"type": "literal", "field": "to", "value": "[email protected]"}],
    "actions": [{"type": "forward", "value": ["[email protected]"]}],
    "priority": 0
  }'