Laravel Cloudflare Mail

A Laravel mail driver for Cloudflare Email Service, the outbound email API on Cloudflare's network. Once installed and configured, the driver plugs into Laravel's mail abstraction. Setting MAIL_MAILER=cloudflare is enough to route every Mail::send, queued mailable, and notification through Cloudflare.

Requirements

PHP 8.4 or newer. Laravel 12.0 or newer. A Cloudflare account with a verified sender domain and an API token that has the email sending permission.

Installation

composer require mateusjunges/laravel-cloudflare-mail

The service provider auto registers via Laravel's package discovery. No manual registration needed.

Quick start

Set the credentials in your .env:

CLOUDFLARE_EMAIL_ACCOUNT_ID=your-account-id
CLOUDFLARE_EMAIL_API_TOKEN=your-api-token
MAIL_MAILER=cloudflare

Add the cloudflare mailer to config/mail.php:

'mailers' => [
    // ...
    'cloudflare' => [
        'transport' => 'cloudflare',
    ],
],

Add the credentials block to config/services.php (the same convention Laravel's built in Postmark and SES drivers follow):

'cloudflare' => [
    'account_id' => env('CLOUDFLARE_EMAIL_ACCOUNT_ID'),
    'api_token' => env('CLOUDFLARE_EMAIL_API_TOKEN'),
],

That's it. Your existing mailables and notifications will now be delivered through Cloudflare. Any key set on the mailer block overrides the matching value in services.cloudflare, which is handy for scoping a second mailer entry to a different account.

Documentation

The docs/ folder covers each topic in more depth:

• Installation. Composer install, local path repositories, and provider registration.
• Configuration. Environment variables, config files, and Cloudflare dashboard setup.
• Usage. Sending mail through the facade, mailables, notifications, and queued jobs.
• Error handling. Exception types, Cloudflare error codes, and retry semantics.

License

The MIT License (MIT). See LICENSE for details.