1# Email Workers Configuration
2 
3## wrangler.jsonc
4 
5```jsonc
6{
7  "name": "email-worker",
8  "main": "src/index.ts",
9  "compatibility_date": "2025-01-27",
10  "send_email": [
11    { "name": "EMAIL" },                                    // Unrestricted
12    { "name": "EMAIL_LOGS", "destination_address": "[email protected]" },  // Single dest
13    { "name": "EMAIL_TEAM", "allowed_destination_addresses": ["[email protected]", "[email protected]"] },
14    { "name": "EMAIL_NOREPLY", "allowed_sender_addresses": ["[email protected]"] }
15  ],
16  "kv_namespaces": [{ "binding": "ARCHIVE", "id": "xxx" }],
17  "r2_buckets": [{ "binding": "ATTACHMENTS", "bucket_name": "email-attachments" }],
18  "vars": { "WEBHOOK_URL": "https://hooks.example.com" }
19}
20```
21 
22## TypeScript Types
23 
24```typescript
25interface Env {
26  EMAIL: SendEmail;
27  ARCHIVE: KVNamespace;
28  ATTACHMENTS: R2Bucket;
29  WEBHOOK_URL: string;
30}
31 
32export default {
33  async email(message: ForwardableEmailMessage, env: Env, ctx: ExecutionContext) {}
34};
35```
36 
37## Dependencies
38 
39```bash
40npm install postal-mime mimetext
41npm install -D @cloudflare/workers-types wrangler typescript
42```
43 
44Use postal-mime v2.x, mimetext v3.x.
45 
46## tsconfig.json
47 
48```json
49{
50  "compilerOptions": {
51    "target": "ES2022", "module": "ES2022", "lib": ["ES2022"],
52    "types": ["@cloudflare/workers-types"],
53    "moduleResolution": "bundler", "strict": true
54  }
55}
56```
57 
58## Local Development
59 
60```bash
61npx wrangler dev
62 
63# Test receiving
64curl --request POST 'http://localhost:8787/cdn-cgi/handler/email' \
65  --url-query '[email protected]' --url-query '[email protected]' \
66  --header 'Content-Type: text/plain' --data-raw 'Subject: Test\n\nHello'
67```
68 
69Sent emails write to local `.eml` files.
70 
71## Deployment Checklist
72 
73- [ ] Enable Email Routing in dashboard
74- [ ] Verify destination addresses
75- [ ] Configure DMARC/SPF/DKIM for sending
76- [ ] Create KV/R2 resources if needed
77- [ ] Update wrangler.jsonc with production IDs
78 
79```bash
80npx wrangler deploy
81npx wrangler deployments list
82```
83 
84## Dashboard Setup
85 
861. **Email Routing:** Domain → Email → Enable Email Routing
872. **Verify addresses:** Email → Destination addresses → Add & verify
883. **Bind Worker:** Email → Email Workers → Create route → Select pattern & Worker
894. **DMARC:** Add TXT `_dmarc.domain.com`: `v=DMARC1; p=quarantine;`
90 
91## Secrets
92 
93```bash
94npx wrangler secret put API_KEY
95# Access: env.API_KEY
96```
97 
98## Monitoring
99 
100```bash
101npx wrangler tail
102npx wrangler tail --status error
103npx wrangler tail --format json
104```
105 
106## Troubleshooting
107 
108| Error | Fix |
109|-------|-----|
110| "Binding not found" | Check `send_email` name matches code |
111| "Invalid destination" | Verify in Email Routing dashboard |
112| Type errors | Install `@cloudflare/workers-types` |
113