toitzi/laravel-cloudflare-mail

Cloudflare Email Service transport for Laravel mailers.
4,848 5
Install
composer require toitzi/laravel-cloudflare-mail
Latest Version:v1.0.2
PHP:^8.4
Laravel:12 · 13
License:MIT
Last Updated:May 27, 2026
Links: GitHub  ·  Packagist
Maintainer: toitzi

Laravel Cloudflare Mail

toitzi/laravel-cloudflare-mail adds a cloudflare mail transport to Laravel so mailers can send through the Cloudflare Email Service REST API.

Installation

composer require toitzi/laravel-cloudflare-mail

Laravel discovers the package automatically.

Configuration

Define the mailer directly in config/mail.php:

'default' => env('MAIL_MAILER', 'cloudflare'),

'mailers' => [
    'cloudflare' => [
        'transport' => 'cloudflare',
        'account_id' => env('CLOUDFLARE_EMAIL_ACCOUNT_ID'),
        'api_token' => env('CLOUDFLARE_EMAIL_API_TOKEN'),
        'base_url' => env('CLOUDFLARE_EMAIL_BASE_URL', 'https://api.cloudflare.com/client/v4'),
        'timeout' => 30,
        'connect_timeout' => 10,
    ],
],

Supported message features

  • HTML and plain text bodies
  • from, to, cc, bcc, and single reply-to addresses
  • Standard attachments
  • Custom headers such as In-Reply-To, References, List-Unsubscribe, and X-*

Limitations

  • Cloudflare's REST API only supports a single from address.
  • Cloudflare's REST API only supports a single reply_to address.
  • Inline attachments are not supported by the REST API and will throw an exception.

Testing

composer test

Related Packages

doctrine/dbal

Powerful PHP database abstraction layer (DBAL) with many features for database s...

641,106,524 9,700
laravel/framework

The Laravel Framework.

593,882,149 34,959
laravel/tinker

Powerful REPL for the Laravel framework.

502,645,077 7,441
laravel/serializable-closure

Laravel Serializable Closure provides an easy and secure way to serialize closur...

418,291,778 609
nunomaduro/collision

Cli error handling for console/command-line PHP applications.

394,964,158 4,660

Version History

Version Released PHP Laravel License
v1.0.2 ^8.4 ^12.0 || ^13.0 MIT
v1.0.1 ^8.3 ^12.0 || ^13.0 MIT
v1.0.0 ^8.3 ^12.0 || ^13.0 MIT