Email

Last updated Jun 9, 2026 Email is a communication channel for agents that need to interact with users or systems through inboxes instead of chat UIs. Agents can send outbound email, receive inbound email, route replies back to an existing session, and use email content as part of an agent workflow.

Use email when you want an agent to:

  • Send notifications, summaries, receipts, or follow-up messages.
  • Process inbound messages through Cloudflare Email Service.
  • Continue a conversation from a reply.
  • Route support, sales, or operational workflows through an agent.

How it works

Outbound email uses a send_email binding in your Worker. Inbound email uses an Email Service routing rule that sends messages to your Worker, where the agent can parse the sender, recipients, headers, and body before deciding how to respond.

For reply handling, include a stable identifier in the reply address, message metadata, or headers so the Worker can route follow-up messages to the right agent instance.

Basic pattern

Implement onEmail() to handle inbound email, and use sendEmail() or replyToEmail() when the agent needs to send a response.

import { Agent, callable, routeAgentEmail } from "agents";
import { createAddressBasedEmailResolver } from "agents/email";

export class EmailAgent extends Agent {
    @callable()
    async sendWelcomeEmail(to) {
        await this.sendEmail({
            binding: this.env.EMAIL,
            to,
            from: "support@yourdomain.com",
            replyTo: "support@yourdomain.com",
            subject: "Welcome",
            text: "Thanks for signing up. Reply to this email if you need help.",
        });
    }

    async onEmail(email) {
        await this.replyToEmail(email, {
            fromName: "Support Agent",
            body: "Thanks for your email. We received it.",
        });
    }
}

export default {
    async email(message, env) {
        await routeAgentEmail(message, env, {
            resolver: createAddressBasedEmailResolver("EmailAgent"),
        });
    },
};

import { Agent, callable, routeAgentEmail } from "agents";
import { createAddressBasedEmailResolver, type AgentEmail } from "agents/email";

export class EmailAgent extends Agent {
    @callable()
    async sendWelcomeEmail(to: string) {
        await this.sendEmail({
            binding: this.env.EMAIL,
            to,
            from: "support@yourdomain.com",
            replyTo: "support@yourdomain.com",
            subject: "Welcome",
            text: "Thanks for signing up. Reply to this email if you need help.",
        });
    }

    async onEmail(email: AgentEmail) {
        await this.replyToEmail(email, {
            fromName: "Support Agent",
            body: "Thanks for your email. We received it.",
        });
    }
}

export default {
    async email(message, env) {
        await routeAgentEmail(message, env, {
            resolver: createAddressBasedEmailResolver("EmailAgent"),
        });
    },
} satisfies ExportedHandler<Env>;

Configuration

Add a send_email binding for outbound email, then configure an Email Service routing rule to send inbound mail to your Worker.

{
  "$schema": "./node_modules/wrangler/config-schema.json",
  "send_email": [
    {
      "name": "EMAIL",
      "remote": true
    }
  ]
}

[[send_email]]
name = "EMAIL"
remote = true

The remote = true option lets you call the real Email Service API during local development with wrangler dev.

Build an email agent

For a complete walkthrough, including domain setup, bindings, inbound routing, and secure replies, use the email agent example.

Email agent

Build an agent that sends, receives, routes, and replies to email using Cloudflare Email Service and the Agents SDK.

Email Service

Route, receive, and send email with Cloudflare Email Service.

Send email from Workers

Use the Workers API to send outbound email.

Was this helpful?

YesNo

On this page

Email - 图1Docs

{"@context":"https://schema.org","@type":"TechArticle","@id":"https://developers.cloudflare.com/agents/communication-channels/email/#page","headline":"Email","description":"Connect agents to email so they can send outbound messages, process inbound mail, and handle follow-up replies.","url":"https://developers.cloudflare.com/agents/communication-channels/email/","inLanguage":"en","image":"https://developers.cloudflare.com/agents/communication-channels/email/og.png?v=77c3698c2ed916ae","dateModified":"2026-06-09","publisher":{"@type":"Organization","name":"Cloudflare","description":"One platform for your apps, agents, and workforce. Build, secure, and scale without managing infrastructure","url":"https://www.cloudflare.com/","sameAs":["https://github.com/cloudflare","https://www.linkedin.com/company/cloudflare","https://x.com/cloudflare"],"logo":{"@type":"ImageObject","url":"https://developers.cloudflare.com/logo.svg"},"address":{"@type":"PostalAddress","streetAddress":"101 Townsend St","addressLocality":"San Francisco","addressRegion":"CA","postalCode":"94107","addressCountry":"US"},"contactPoint":[{"@type":"ContactPoint","contactType":"Customer Support","url":"https://support.cloudflare.com/","availableLanguage":["English"]},{"@type":"ContactPoint","contactType":"Sales","url":"https://www.cloudflare.com/contact/","availableLanguage":["English"]}]},"isPartOf":{"@type":"WebSite","@id":"https://developers.cloudflare.com/#website","name":"Cloudflare Docs","url":"https://developers.cloudflare.com/"}}

description: Connect agents to Slack workspaces so they can respond to direct messages, mentions, and threaded conversations. title: Slack image: https://developers.cloudflare.com/agents/communication-channels/slack/og.png?v=08e77a5025b2e16f

Skip to content

Documentation Index
Fetch the complete documentation index at: https://developers.cloudflare.com/agents/llms.txt
Use this file to discover all available pages before exploring further.