Skip to content
Cloudflare Docs
DirectoryAPISDKsChangelog

Send emails

Send your first email using the Workers binding, the REST API, or SMTP.

Send emails from your applications using Cloudflare Email Service. You can use the Workers binding for applications built on Cloudflare Workers, the REST API from any platform, or SMTP from any SMTP-capable application or mail client.

Set up your domain

Before using Email Sending, configure your domain.

  1. In the Cloudflare dashboard, go to Compute > Email Service > Email Sending.

    Go to Email Sending

  2. Select Onboard Domain.

  3. Choose a domain from your Cloudflare account. Optionally review the DNS records that Cloudflare will add to the cf-bounce subdomain of your domain:

    • MX records to route bounce emails to Cloudflare.
    • TXT record for SPF to authorize sending emails.
    • TXT record for DKIM to provide authentication for emails sent from your domain.
    • TXT record for DMARC on _dmarc.yourdomain.com.

  4. Select Done.

Once your domain is onboarded, you can start sending emails.

Send your first email

You can send your first email using the Workers binding, the REST API, or SMTP.

If you are building on Cloudflare Workers, you can use the Workers binding for native email sending. Start by creating a new Worker project.

  1. Create a new Worker project:

    npm create cloudflare@latest -- email-service-tutorial

    When prompted, select "Hello World" Worker as the template.

  2. Add the email binding to your Wrangler configuration file:

    JSONC
    {
      "send_email": [
        {
          "name": "EMAIL",
          "remote": true,
        },
      ],
    }

  3. Create your Worker code in src/index.ts:

    TypeScript
    // Configuration - Update these values
    const YOUR_DOMAIN = "yourdomain.com"; // Replace with your verified domain
    const RECIPIENT_EMAIL = "recipient@example.com"; // Replace with your email to receive test emails
    

    export default {
      async fetch(request: Request, env: Env): Promise<Response> {
        // Send a welcome email
        const response = await env.EMAIL.send({
          to: RECIPIENT_EMAIL,
          from: `welcome@${YOUR_DOMAIN}`,
          subject: "Welcome to our service!",
          html: "<h1>Welcome!</h1><p>Thanks for signing up.</p>",
          text: "Welcome! Thanks for signing up.",
        });
    

        return new Response(`Email sent: ${response.messageId}`);
      },
    } satisfies ExportedHandler<Env>;

  4. Use npx wrangler dev to develop your Worker project and send emails. This runs your code locally while connecting to Cloudflare Email Service (using remote bindings).

    Terminal window
    npx wrangler dev
    # ⎔ Starting remote preview...
    # Total Upload: 24.96 KiB / gzip: 6.17 KiB
    # [wrangler:info] Ready on http://localhost:8787

  5. Deploy your Worker:

    Terminal window
    npm run deploy

After deploying, test that your Worker can send emails:

  1. Visit your Worker URL in a browser (shown in the deploy output, for example: https://email-service-tutorial.<your-subdomain>.workers.dev).
  2. You should see a response like Email sent: <message-id>.
  3. Check the inbox for the email address you specified in RECIPIENT_EMAIL. If you do not see the email, check your spam folder.

Next steps

Now that you can send emails, explore advanced features: