Looking to hire Laravel developers? Try LaraJobs

laravel-cloudflare-mail maintained by toitzi

Description
Cloudflare Email Service transport for Laravel mailers.
Last update
2026/04/16 19:20 (dev-main)
License
Downloads
2

Comments
comments powered by Disqus

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