Cloudflare Email Sending

A drop-in email provider that routes Strapi's Email feature through Cloudflare Email Service.

It replaces the default sendmail provider (which is only suitable for local development) with Cloudflare's transactional email API: no SMTP relay to run, no separate email SaaS, and delivery is authenticated with SPF/DKIM by Cloudflare for your onboarded domain.

Installation

npm

npm install @fbritoferreira/strapi-provider-email-cloudflare

yarn

yarn add @fbritoferreira/strapi-provider-email-cloudflare

pnpm

pnpm add @fbritoferreira/strapi-provider-email-cloudflare

bun

bun add @fbritoferreira/strapi-provider-email-cloudflare

Quick start

1. Set up Cloudflare Email Sending for your domain and create an API token.
2. Point Strapi's email config at the provider:

// config/plugins.ts
export default ({ env }) => ({
  email: {
    config: {
      provider: '@fbritoferreira/strapi-provider-email-cloudflare',
      providerOptions: {
        apiToken: env('CLOUDFLARE_API_TOKEN'),
        accountId: env('CLOUDFLARE_ACCOUNT_ID'),
      },
      settings: {
        defaultFrom: 'no-reply@yourdomain.com',
        defaultReplyTo: 'support@yourdomain.com',
      },
    },
  },
});

3. Send as usual — from a controller, service, or lifecycle hook:

await strapi.plugin('email').service('email').send({
  to: 'user@example.com',
  subject: 'Welcome!',
  html: '<h1>Welcome</h1>',
  text: 'Welcome',
});

Every send() call now hits Cloudflare's POST /accounts/{account_id}/email/sending/send.

How it fits into Strapi

Strapi's Email feature delegates delivery to a provider module: at boot it resolves email.config.provider, calls init(providerOptions, settings), and routes all email.send() traffic to the returned send() function. This package is that module — there is no admin UI, no routes, and no extra process. See Strapi's provider documentation for the contract it implements.

Requirements

• Strapi 5 (@strapi/strapi ^5.0.0)
• Cloudflare Workers Paid plan (Email Sending is not on the Free plan)
• A domain onboarded to Email Sending, and an API token with Email Sending permission
• Node 20.3 or newer

Guides

• Cloudflare setup — plan, domain, DNS records, API token, account ID
• Configuration — provider options, defaults, environment variables
• Sending email — examples, attachments, returned result, errors and limits