Laravel Mailjet

Fluent Mailjet API v3 integration & mail transport for Laravel.

Send transactional mail through the Laravel Mail facade, or talk to the full Mailjet REST API — contacts, lists, campaigns, templates and webhooks — with an expressive wrapper.

Table of contents

• Features
• Requirements
• Installation
• Configuration
• Sending mail with the Mailjet transport
• Using the Mailjet API
• Optional service providers
• Sandbox mode
• Documentation
• Testing
• Contributing
• License

Features

• 📨 Drop-in mail transport — set one env var and every Mailable / Notification goes through Mailjet.
• 🧩 Full API v3 wrapper — low-level get / post / put / delete plus high-level helpers, built on the official mailjet/mailjet-apiv3-php client.
• 🗂️ Resource managers — dedicated, injectable services for contacts, lists, metadata, campaigns, campaign drafts, templates and event callbacks.
• 🧪 Sandbox mode — validate payloads in CI and local development without sending a single email.
• ⚡ Zero-config setup — package auto-discovery registers the provider and Mailjet facade for you.

Requirements

Installation

composer require mailjet/laravel-mailjet

That's it. Package auto-discovery wires up the MailjetServiceProvider and the Mailjet facade automatically.

Laravel 11 and newer — bootstrap/providers.php:

use Mailjet\LaravelMailjet\MailjetServiceProvider;

return [
    App\Providers\AppServiceProvider::class,
    MailjetServiceProvider::class,
];

Laravel 10 and older — config/app.php:

'providers' => [
    // ...
    Mailjet\LaravelMailjet\MailjetServiceProvider::class,
],

'aliases' => [
    // ...
    'Mailjet' => Mailjet\LaravelMailjet\Facades\Mailjet::class,
],

Configuration

Grab your API key and secret from the Mailjet account settings.

1. Add your credentials to .env:

MAILJET_APIKEY=your_api_key
MAILJET_APISECRET=your_api_secret

MAIL_FROM_ADDRESS=you@example.com
MAIL_FROM_NAME="Your App"

# Optional — process requests without actually sending
MAILJET_SANDBOX=false

2. Register the service in config/services.php:

'mailjet' => [
    'key'     => env('MAILJET_APIKEY'),
    'secret'  => env('MAILJET_APISECRET'),
    // filter_var keeps the "true"/"false" env string honest (handy in Docker)
    'sandbox' => filter_var(env('MAILJET_SANDBOX', false), FILTER_VALIDATE_BOOLEAN),
],

Need to tune the API URL, version, or the transactional/common/v4 clients? See the full configuration reference.

Sending mail with the Mailjet transport

1. Select the transport in .env:

MAIL_MAILER=mailjet

Laravel 6 and older use the MAIL_DRIVER key instead.

2. Declare the mailer in config/mail.php:

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

3. Send as usual — no Mailjet-specific code required:

use Illuminate\Support\Facades\Mail;

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

Make sure the from address is a verified Mailjet sender. More patterns (Mailjet templates, variables, custom headers) live in the examples guide.

Using the Mailjet API

Import the facade:

use Mailjet\LaravelMailjet\Facades\Mailjet;

Low-level requests

Mailjet::get($resource, $args, $options);
Mailjet::post($resource, $args, $options);
Mailjet::put($resource, $args, $options);
Mailjet::delete($resource, $args, $options);

Every call returns a Mailjet\Response, or throws a Mailjet\LaravelMailjet\Exception\MailjetException on an API error. Filter arguments are documented in the Mailjet API reference.

High-level helpers

Mailjet::getAllLists($filters);
Mailjet::createList($body);
Mailjet::getListRecipients($filters);
Mailjet::getSingleContact($id);
Mailjet::createContact($body);
Mailjet::createListRecipient($body);
Mailjet::editListrecipient($id, $body);

Custom requests

$client = Mailjet::getClient(); // the underlying \Mailjet\Client instance

Optional service providers

Each Mailjet resource has a focused, injectable manager. Register only the providers you use in config/app.php (or bootstrap/providers.php on Laravel 11+):

// config/app.php
'providers' => [
    // ...
    Mailjet\LaravelMailjet\Providers\ContactsServiceProvider::class,
],

Then resolve the manager wherever you need it:

use Mailjet\LaravelMailjet\Services\ContactsV4Service;

public function handle(ContactsV4Service $contacts)
{
    $contacts->delete(351406781);
}

Sandbox mode

With MAILJET_SANDBOX=true, Mailjet validates the request and returns a successful response without delivering any email — ideal for staging environments and automated tests.

MAILJET_SANDBOX=true

Details in the configuration reference.

Documentation

Testing

composer install
bin/phpunit

Contributing

Issues and pull requests are welcome — see CONTRIBUTING.md.

License

Released under the MIT License.