1# Email Routing Configuration
2 
3## Wrangler Configuration
4 
5### Basic Email Worker
6 
7```jsonc
8// wrangler.jsonc
9{
10  "name": "email-worker",
11  "main": "src/index.ts",
12  "compatibility_date": "2025-01-01",
13  "send_email": [{ "name": "EMAIL" }]
14}
15```
16 
17```typescript
18// src/index.ts
19export default {
20  async email(message, env, ctx) {
21    await message.forward("[email protected]");
22  }
23} satisfies ExportedHandler;
24```
25 
26### With Storage Bindings
27 
28```jsonc
29{
30  "name": "email-processor",
31  "send_email": [{ "name": "EMAIL" }],
32  "kv_namespaces": [{ "binding": "KV", "id": "abc123" }],
33  "r2_buckets": [{ "binding": "R2", "bucket_name": "emails" }],
34  "d1_databases": [{ "binding": "DB", "database_id": "def456" }]
35}
36```
37 
38```typescript
39interface Env {
40  EMAIL: SendEmail;
41  KV: KVNamespace;
42  R2: R2Bucket;
43  DB: D1Database;
44}
45```
46 
47## Local Development
48 
49```bash
50npx wrangler dev
51 
52# Test with curl
53curl -X POST 'http://localhost:8787/__email' \
54  --header 'content-type: message/rfc822' \
55  --data 'From: [email protected]
56To: [email protected]
57Subject: Test
58 
59Body'
60```
61 
62## Deployment
63 
64```bash
65npx wrangler deploy
66```
67 
68**Connect to Email Routing:**
69 
70Dashboard: Email > Email Routing > [domain] > Settings > Email Workers > Select worker
71 
72API:
73```bash
74curl -X PUT "https://api.cloudflare.com/client/v4/zones/$ZONE_ID/email/routing/settings" \
75  -H "Authorization: Bearer $API_TOKEN" \
76  -d '{"enabled": true, "worker": "email-worker"}'
77```
78 
79## DNS (Auto-Created)
80 
81```dns
82yourdomain.com. IN MX 1 isaac.mx.cloudflare.net.
83yourdomain.com. IN MX 2 linda.mx.cloudflare.net.
84yourdomain.com. IN MX 3 amir.mx.cloudflare.net.
85yourdomain.com. IN TXT "v=spf1 include:_spf.mx.cloudflare.net ~all"
86```
87 
88## Secrets & Variables
89 
90```bash
91# Secrets (encrypted)
92npx wrangler secret put API_KEY
93 
94# Variables (plain)
95# wrangler.jsonc
96{ "vars": { "THRESHOLD": "5.0" } }
97```
98 
99```typescript
100interface Env {
101  API_KEY: string;
102  THRESHOLD: string;
103}
104```
105 
106## TypeScript Setup
107 
108```bash
109npm install --save-dev @cloudflare/workers-types
110```
111 
112```json
113// tsconfig.json
114{
115  "compilerOptions": {
116    "target": "ES2022",
117    "module": "ES2022",
118    "lib": ["ES2022"],
119    "types": ["@cloudflare/workers-types"],
120    "moduleResolution": "bundler",
121    "strict": true
122  }
123}
124```
125 
126```typescript
127import type { ForwardableEmailMessage } from "@cloudflare/workers-types";
128 
129export default {
130  async email(message: ForwardableEmailMessage, env: Env, ctx: ExecutionContext): Promise<void> {
131    await message.forward("[email protected]");
132  }
133} satisfies ExportedHandler<Env>;
134```
135 
136## Dependencies
137 
138```bash
139npm install postal-mime
140```
141 
142```typescript
143import PostalMime from 'postal-mime';
144 
145export default {
146  async email(message, env, ctx) {
147    const parser = new PostalMime();
148    const email = await parser.parse(await message.raw.arrayBuffer());
149    console.log(email.subject);
150    await message.forward("[email protected]");
151  }
152} satisfies ExportedHandler;
153```
154 
155## Multi-Environment
156 
157```bash
158# wrangler.dev.jsonc
159{ "name": "worker-dev", "vars": { "ENV": "dev" } }
160 
161# wrangler.prod.jsonc
162{ "name": "worker-prod", "vars": { "ENV": "prod" } }
163 
164npx wrangler deploy --config wrangler.dev.jsonc
165npx wrangler deploy --config wrangler.prod.jsonc
166```
167 
168## CI/CD (GitHub Actions)
169 
170```yaml
171# .github/workflows/deploy.yml
172name: Deploy
173on:
174  push:
175    branches: [main]
176jobs:
177  deploy:
178    runs-on: ubuntu-latest
179    steps:
180      - uses: actions/checkout@v3
181      - uses: actions/setup-node@v3
182      - run: npm ci
183      - run: npx wrangler deploy
184        env:
185          CLOUDFLARE_API_TOKEN: ${{ secrets.CLOUDFLARE_API_TOKEN }}
186```
187