README

Cloud hosts block SMTP ports for security. Send over HTTPS port 443 instead. Your email code doesn't change.

Laravel HTTP Mailer

Problem: cloud hosts block SMTP ports (25, 465, 587) for security, so Laravel emails time out.
Fix: send through the SendGrid or Brevo API over HTTPS (port 443).
No changes to your email code. Your Mailables and Notifications keep working as they are. Just one line in .env.

Why

SMTP: ports 25, 465 and 587 are blocked on AWS, DigitalOcean, Google Cloud and Hetzner, and you see 'Connection timed out'. HTTP API: port 443 is open on every host, and errors are clear, like '403: sender not verified'. Your email code doesn't change.

No code changes

Everything you already send keeps working. Only .env changes.


Mailables	`Mail::to($user)->send(new WelcomeMail)`
Notifications (mail channel)	`$user->notify(new OrderShipped($order))`
Queued mail	`Mail::to($user)->queue(new InvoiceMail)`
Raw mail	`Mail::raw('Hi', fn ($m) => $m->to($email))`

How it compares

Comparison of this package with the Symfony mailer bridges, s-ichikawa/laravel-sendgrid-driver and the official sendgrid/sendgrid SDK.

Same comparison as text

Package	Mailables & Notifications	SendGrid + Brevo	No glue code
lmottasin/laravel-http-mailer
`symfony/*-mailer` bridges
`s-ichikawa/laravel-sendgrid-driver`
`sendgrid/sendgrid` (SDK)

Requirements

	Version
PHP	8.2 or newer
Laravel	12 or 13 (11 best-effort: it is end-of-life)
Account	SendGrid or Brevo, with an API key

Setup in 3 steps

1. Install

composer require lmottasin/laravel-http-mailer

Laravel finds the package automatically. You don't have to register anything.

2. Update your `.env`

A fresh Laravel app has a mail block like the one below. Comment out the SMTP lines you don't need anymore, then add your provider settings.

Using SendGrid

# --- Old SMTP settings (not needed anymore, keep them commented) ---
# MAIL_MAILER=smtp
# MAIL_SCHEME=null
# MAIL_HOST=smtp.sendgrid.net
# MAIL_PORT=587
# MAIL_USERNAME=apikey
# MAIL_PASSWORD=SG.xxxxxxxx

# --- New: send through the SendGrid HTTP API ---
MAIL_MAILER=sendgrid
SENDGRID_API_KEY=SG.xxxxxxxxxxxxxxxxxxxxxxxx

# --- Keep these, they are still used ---
MAIL_FROM_ADDRESS="no-reply@yourdomain.com"
MAIL_FROM_NAME="${APP_NAME}"

Get a key at SendGrid → Settings → API Keys → Create API Key (the "Mail Send" permission is enough).

Using Brevo

# --- Old SMTP settings (not needed anymore, keep them commented) ---
# MAIL_MAILER=smtp
# MAIL_SCHEME=null
# MAIL_HOST=smtp-relay.brevo.com
# MAIL_PORT=587
# MAIL_USERNAME=your-login@smtp-brevo.com
# MAIL_PASSWORD=xsmtpsib-xxxxxxxx

# --- New: send through the Brevo HTTP API ---
MAIL_MAILER=brevo
BREVO_API_KEY=xkeysib-xxxxxxxxxxxxxxxxxxxxxxxx

# --- Keep these, they are still used ---
MAIL_FROM_ADDRESS="no-reply@yourdomain.com"
MAIL_FROM_NAME="${APP_NAME}"

Get a key at Brevo → SMTP & API → API Keys → Generate a new API key. Note: Brevo's API key starts with xkeysib-. The SMTP password (xsmtpsib-) won't work here.

Want both? Set both keys and switch anytime

MAIL_MAILER=sendgrid            # change to "brevo" to switch
SENDGRID_API_KEY=SG.xxxxxxxx
BREVO_API_KEY=xkeysib-xxxxxxxx

Variable	What it does	Required?
`MAIL_MAILER`	Which provider to use: `sendgrid` or `brevo`	Yes
`SENDGRID_API_KEY`	Your SendGrid API key (starts with `SG.`)	If using SendGrid
`BREVO_API_KEY`	Your Brevo API key (starts with `xkeysib-`)	If using Brevo
`MAIL_FROM_ADDRESS`	Sender email. Its domain must be verified with your provider.	Yes
`MAIL_FROM_NAME`	Sender name shown in the inbox	Recommended
`MAIL_HOST`, `MAIL_PORT`, `MAIL_USERNAME`, `MAIL_PASSWORD`, `MAIL_SCHEME`	SMTP only. Not used by this package.	No

3. Clear the config cache

php artisan config:clear

That's it. Send a test email:

php artisan tinker --execute 'Mail::raw("It works!", fn ($m) => $m->to("you@example.com")->subject("Test"));'

Important

Verify your sender domain first. The domain in MAIL_FROM_ADDRESS has to be verified in your provider's dashboard (SendGrid → Sender Authentication, Brevo → Senders, Domains & Dedicated IPs). If it isn't, the API rejects the email with HTTP 403.

Usage (no code changes)

Nothing to change. Keep writing mail code exactly as you do today:

Mail::to($user)->send(new WelcomeMail($user));

$user->notify(new OrderShipped($order));

Mail::raw('Hello!', fn ($message) => $message->to('jane@example.com')->subject('Hi'));

Send one email through a different provider than your default:

Mail::mailer('brevo')->to($user)->send(new InvoiceMail($invoice));

Automatic backup provider (failover)

If SendGrid has an outage, Laravel can retry the email through Brevo automatically. Add this to config/mail.php:

'mailers' => [
    // ...your other mailers

    'api' => [
        'transport' => 'failover',
        'mailers' => ['sendgrid', 'brevo'], // tried in this order
    ],
],

Then set MAIL_MAILER=api in .env, along with both API keys.

Optional settings

API keys are read from config/services.php, like Laravel's own Mailgun, Postmark and Resend keys. The package fills in these defaults, so you only need to touch services.php to change them:

'sendgrid' => [
    'key' => env('SENDGRID_API_KEY'),
    'region' => env('SENDGRID_REGION'), // "eu" for SendGrid EU accounts
],

'brevo' => [
    'key' => env('BREVO_API_KEY'),
],

Note

If your config/services.php already has a sendgrid or brevo block, the package leaves it as it is. Add 'region' => env('SENDGRID_REGION') to it yourself if you need the EU region.

Per-mailer settings. The package adds sendgrid and brevo to mail.mailers for you. If you define them yourself in config/mail.php, yours wins:

'mailers' => [
    'sendgrid' => [
        'transport' => 'sendgrid',
        'key' => env('MY_OTHER_SENDGRID_KEY'), // if this is missing you get a clear error, never another account's key
        'region' => 'eu',                      // SendGrid EU data residency ("global" or "eu")
        'client' => ['timeout' => 5],          // Symfony HTTP client options
    ],
],

A missing or empty key throws MissingApiKeyException with the name of the .env variable to set, instead of failing later with an HTTP 401.

Safe HTTP defaults. Every request has a 10 s timeout, a 30 s maximum duration and does not follow redirects, so a slow API can't hang your app and the API key is never sent to another host. Change them with the mailer's client option.

Region only accepts global or eu. Anything else throws, because the value becomes part of the API hostname.

Supported providers

Provider	`MAIL_MAILER` value	API key env	Built on
SendGrid	`sendgrid`	`SENDGRID_API_KEY`	`symfony/sendgrid-mailer`
Brevo (formerly Sendinblue)	`brevo`	`BREVO_API_KEY`	`symfony/brevo-mailer`

Need Mailgun, Postmark, Resend or something else? Check whether Laravel already supports it (Mailgun, Postmark, Resend and SES are built in). If not, you can add it yourself in about 20 lines. See below.

Adding a new provider

You can add a provider from your own app, without forking the package.

1. Create a class that implements TransportFactory (for example app/Mail/FooTransportFactory.php):

use Lmottasin\HttpMailer\Contracts\TransportFactory;
use Symfony\Component\Mailer\Bridge\Foo\Transport\FooTransportFactory as SymfonyFoo;
use Symfony\Component\Mailer\Transport\Dsn;
use Symfony\Component\Mailer\Transport\TransportInterface;

final class FooTransportFactory implements TransportFactory
{
    public static function name(): string
    {
        return 'foo'; // MAIL_MAILER=foo
    }

    public function transport(array $config): TransportInterface
    {
        return (new SymfonyFoo)->create(
            new Dsn('foo+api', 'default', $config['key'] ?? config('services.foo.key')),
        );
    }
}

2. List it in the published config (php artisan vendor:publish --tag=http-mailer-config):

// config/http-mailer.php
'drivers' => [
    SendGridDriver::class,
    BrevoDriver::class,
    App\Mail\FooTransportFactory::class,
],

That's it: MAIL_MAILER=foo now works. Names must be unique, can't contain a dot, and can't reuse a Laravel transport name such as smtp or log. Want it built in for everyone? See CONTRIBUTING.md.

How it works under the hood

register() merges the package config and default services keys, then adds a mail.mailers.<name> entry for each driver (unless you already defined one).
boot() waits until Laravel's mail manager is first used, then registers each driver with extend(). Requests that send no mail pay nothing.
When Laravel sends an email, the driver builds a Symfony transport through the official SendGrid or Brevo bridge, and that transport makes an HTTPS request to the provider's API.

Troubleshooting

Same fixes as text

Error	Fix
`403` sender not verified	Verify your domain with the provider
`401` invalid API key	Check the key. Brevo needs `xkeysib-`, not the SMTP password
`MissingApiKeyException`	Set the `.env` variable named in the message, then `php artisan config:clear`
Timeout on port 587	Set `MAIL_MAILER=sendgrid` (or `brevo`)
`.env` changes ignored	`php artisan config:clear`
SendGrid EU account rejects requests	Set `SENDGRID_REGION=eu`
`Unsupported mail transport [sendgrid]`	`php artisan optimize:clear` (stale package or config cache)
Queued mail lost	Check `failed_jobs` and `storage/logs`

FAQ

Why do Laravel emails time out on DigitalOcean, AWS, Google Cloud or Hetzner? These hosts block outgoing SMTP ports (25, 465, 587) to stop spam. Laravel's default smtp mailer uses those ports, so the connection times out.

How do I send Laravel email when port 587 is blocked? Install this package and set MAIL_MAILER=sendgrid (or brevo). Mail goes out over the provider's HTTPS API on port 443, which is never blocked.

Do I need to change my Mailables or Notifications? No. Mail::to()->send(), queued mail and mail Notifications keep working. Only .env changes.

Can I just ask my host to unblock SMTP? Sometimes, but it takes a support ticket and is often refused. An HTTP API works right away.

SendGrid or Brevo? Either. Set both keys and use Laravel's failover mailer to switch automatically if one is down.

Does it work with Laravel 11, 12 and 13, Octane and queues? Yes. Laravel 12 and 13 are fully supported, 11 is best-effort (end-of-life). Octane, queue workers and config:cache are covered by the tests.

Testing

composer install
composer test

Changelog

See CHANGELOG.md.

Contributing

See CONTRIBUTING.md.

Security

Found a security problem? Please report it privately. See SECURITY.md.

Credits

lmottasin · lmottasin@gmail.com
All contributors
Provider logos from Simple Icons (CC0). SendGrid, Brevo and Laravel are trademarks of their owners. This package is not affiliated with them.

License

MIT. See LICENSE.md.

lmottasin / laravel-http-mailer

Package info

Security

Statistics

README

Laravel HTTP Mailer

Why

No code changes

How it compares

Requirements

Setup in 3 steps

1. Install

2. Update your `.env`

3. Clear the config cache

Usage (no code changes)

Automatic backup provider (failover)

Optional settings

Supported providers

Adding a new provider

How it works under the hood

Troubleshooting

FAQ

Related links

Testing

Changelog

Contributing

Security

Credits

License

lmottasin / laravel-http-mailer

Package info

Security

Statistics

README

Laravel HTTP Mailer

Why

No code changes

How it compares

Requirements

Setup in 3 steps

1. Install

2. Update your .env

3. Clear the config cache

Usage (no code changes)

Automatic backup provider (failover)

Optional settings

Supported providers

Adding a new provider

How it works under the hood

Troubleshooting

FAQ

Related links

Testing

Changelog

Contributing

Security

Credits

License

2. Update your `.env`