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

| Package | Supported versions | | --- | --- | | PHP | 7.4 · 8.x | | Laravel | 9.x – 13.x | | Symfony Mailer / Mailjet Mailer | 6.x · 7.x · 8.x |

Installation

composer require mailjet/laravel-mailjet

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

use Mailjet\LaravelMailjet\MailjetServiceProvider;

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

'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:

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:

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+):

| Service provider | Manages | Contract | | --- | --- | --- | | Providers\ContactsServiceProvider | Contacts, incl. deletion (API v4) | ContactsV4Contract | | Providers\ContactsListServiceProvider | Contact lists | ContactsListContract | | Providers\ContactMetadataServiceProvider | Contact properties / metadata | ContactMetadataContract | | Providers\CampaignServiceProvider | Campaigns | CampaignContract | | Providers\CampaignDraftServiceProvider | Campaign drafts | CampaignDraftContract | | Providers\TemplateServiceProvider | Templates | TemplateServiceContract | | Providers\EventCallbackUrlServiceProvider | Event (webhook) callback URLs | EventCallbackUrlContract |

// 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.

Details in the configuration reference.

Documentation

| Resource | Link | | --- | --- | | Configuration reference | docs/configuration.md | | Examples (campaigns, templates, Mailables) | docs/usage.md | | Full docs site | https://mailjet.github.io/laravel-mailjet/ | | Mailjet API v3 | https://dev.mailjet.com/ | | PHP API client | https://github.com/mailjet/mailjet-apiv3-php |

Testing

composer install
bin/phpunit

Contributing

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

License

Released under the MIT License.