All docs

Email routing

Receive email at your own domain and handle each message with code, or forward it.

Email routing receives mail for addresses at your domain and decides what happens to each message: run an app's email handler, or forward it to another address. The original message is saved to a bucket. For full mailboxes people read in a mail app, see Mailboxes.

Add your domain

1Add the domain under Email routing.
2Create the TXT record shown to prove you own it, and the MX record shown on the domain's page.
3Press Verify. Mail starts arriving once the MX change has spread.

Routes

Routes are checked in priority order and the first match wins:

export default {
  async email(message, env) {
    if (!message.spfPass && !message.dkimPass) {
      message.setReject("Unauthenticated sender");
      return;
    }
    const text = await message.text();
    await env.DB.prepare("INSERT INTO tickets (sender, body) VALUES (?, ?)")
      .bind(message.from, text).run();
    await message.forward("team@example.com");
  },
};

Exact	`support` matches only support@your-domain
Prefix	`order-` matches order-123@, order-abc@ …
Catch-all	Everything not matched above

Email routing

Add your domain

Routes

Handle mail with code

Sending