PHPackages                             dennis-koster/laravel-maileon - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Mail &amp; Notifications](/categories/mail)
4. /
5. dennis-koster/laravel-maileon

ActiveLibrary[Mail &amp; Notifications](/categories/mail)

dennis-koster/laravel-maileon
=============================

Maileon mail driver for Laravel

3.0.0(1y ago)22.5kMITPHPPHP ^8.2

Since Aug 2Pushed 1y ago1 watchersCompare

[ Source](https://github.com/dennis-koster/laravel-maileon)[ Packagist](https://packagist.org/packages/dennis-koster/laravel-maileon)[ Docs](https://github.com/dennis-koster/laravel-maileon)[ RSS](/packages/dennis-koster-laravel-maileon/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (10)Dependencies (12)Versions (14)Used By (0)

Laravel Maileon
===============

[](#laravel-maileon)

[![Software License](https://camo.githubusercontent.com/ecc2af3a7f176e4e274b8ee050d92b5f77fb70647b304c6f8e3bcd63b695016c/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f64656e6e69732d6b6f737465722f6c61726176656c2d6d61696c656f6e2e737667)](LICENSE.MD)[![Latest Version on Packagist](https://camo.githubusercontent.com/0d5d26a7f3f74922e77817f1d52b20a693be7bd8ee36c564623b52f41349f9d6/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f64656e6e69732d6b6f737465722f6c61726176656c2d6d61696c656f6e2e737667)](https://packagist.org/packages/dennis-koster/laravel-maileon)[![GitHub Tests Action Status](https://camo.githubusercontent.com/256c0afbfc8fc4256efa0b2a822f7df267ac8ce0f8dd1de57c71fed6f3af12d7/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f776f726b666c6f772f7374617475732f64656e6e69736b6f737465722f6c61726176656c2d6d61696c656f6e2f54657374733f6c6162656c3d7465737473)](https://github.com/dennis-koster/laravel-maileon/actions?query=workflow%3ATests+branch%3Amaster)[![Coverage Status](https://camo.githubusercontent.com/54d83e144f54b4807a09917ded1b8656ca88b66dc25ed2bc073e05375fcc726b/68747470733a2f2f636f766572616c6c732e696f2f7265706f732f6769746875622f64656e6e69732d6b6f737465722f6c61726176656c2d6d61696c656f6e2f62616467652e7376673f6272616e63683d6d6173746572)](https://coveralls.io/github/dennis-koster/laravel-maileon?branch=master)

This package adds a custom mail driver for Maileon to Laravel.

Some configuration in the Maileon user interface is required.

Requirements
------------

[](#requirements)

- [laravel/laravel:^8.0 || ^.0](https://github.com/laravel/laravel)
- [bensampo/laravel-enum:^6.1.0](https://github.com/BenSampo/laravel-enum)
- [guzzlehttp/psr7:^1.8](https://github.com/guzzle/psr7)
- [php-http/discovery:^1.14](https://github.com/php-http/discovery)
- [psr/http-client:^1.0](https://github.com/php-fig/http-client)
- [psr/http-message:^1.0](https://github.com/php-fig/http-message)

Installation
------------

[](#installation)

Install the package:

```
composer require dennis-koster/laravel-maileon
```

Publish the configuration file:

```
php artisan vendor:publish --provider="DennisKoster\\LaravelMaileon\\Providers\\LaravelMaileonServiceProvider"
```

Add the missing environment variables to your `.env` file:

```
MAILEON_API_URL=
MAILEON_API_KEY=
MAILEON_TRANSACTIONAL_CONTACT_EVENT=

```

Configure Maileon
-----------------

[](#configure-maileon)

Maileon does not support sending transactional emails out of the box. We need to take a couple of steps in the Maileon interface to set everything up.

### 1. Creating the contact event

[](#1-creating-the-contact-event)

After logging in, go to "Lists &amp; Contacts" in the top menu. Then click "Contact events" in the left menu, and then click the button "Create a new contact event".

Use the following settings:

```
Name: API_Transactional
Description: Contact event used for sending transactional emails
Further processing: Enabled
Retention period: 30 Days

```

Then create these two fields:

```
Name: subject
Description: Subject of the email
Mandatory: Yes
Format: Text

```

```
Name: body_html
Description: The HTML content of the email
Mandatory: Yes
Format: JSON (!! Very important and counter-intuitive)

```

[![Image of create custom event](docs/create-contact-event.png)](docs/create-contact-event.png)

### 2. Setting up the trigger

[](#2-setting-up-the-trigger)

Click Mailings in the top menu, and then navigate to "Trigger drafts" in the left menu. Then click the `[new trigger draft]` button.

Choose the "New content editor" option when prompted.

Enter a name that's easily recognizable like "Transactional mail"

For the subject, click the blue `[.]` icon to the right side of the input field. Select the type `Contact event (transactional)`. Then select the Contact event we just created (`API_Transactional`) and select the property `subject`. Finally, press the `[Insert personalization]` button.

[![Image of selecting subject](docs/select-subject.png)](docs/select-subject.png)

Enter your sender details and then click the blue `Continue` button in the right bottom corner.

Choose the "From scratch option".

When presented with the drag and drop editor, click the `[Drag & drop editor]` button on the bottom left of the screen, and select `Code editor`.

Remove all contents in the code editor and replace it with the following:

```
[[TRANSACTION|"body_html[0]"]]
```

Then click the `[Save]` button in the top right corner, followed by the `X Close` button.

Click the blue `Contine` button again in the bottom right corner of the screen, to go to the `Dispatch logic & Approval` screen.

For the `Mailing logic` type, select `Single dispatch for an event` and then for incident, select the trigger we created (`API_Transactional`).

Enable `Permission neutral sendout`.

[![Image of mailing logic settings](docs/display-logic.png)](docs/display-logic.png)

Finally, click the `[activate Trigger-mailing]` button in the bottom right corner.

###  Health Score

36

—

LowBetter than 82% of packages

Maintenance33

Infrequent updates — may be unmaintained

Popularity19

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity71

Established project with proven stability

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~120 days

Recently: every ~267 days

Total

10

Last Release

659d ago

Major Versions

1.0.6 → 2.0.02022-11-25

2.0.1 → 3.0.02024-07-22

PHP version history (3 changes)1.0.0PHP ^7.4 || ^8.0

2.0.0PHP ^8.0

3.0.0PHP ^8.2

### Community

Maintainers

![](https://www.gravatar.com/avatar/48a35604e924d56a81bff335b7e1f2dce0fb905b86e379f804207dbb956b9b40?d=identicon)[denniskoster](/maintainers/denniskoster)

---

Top Contributors

[![dennis-koster](https://avatars.githubusercontent.com/u/8804219?v=4)](https://github.com/dennis-koster "dennis-koster (6 commits)")

---

Tags

laravelmaileonmail driverdennis-kosterlaravel-maileon

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/dennis-koster-laravel-maileon/health.svg)

```
[![Health](https://phpackages.com/badges/dennis-koster-laravel-maileon/health.svg)](https://phpackages.com/packages/dennis-koster-laravel-maileon)
```

###  Alternatives

[sylius/sylius

E-Commerce platform for PHP, based on Symfony framework.

8.4k5.6M651](/packages/sylius-sylius)[mailgun/mailgun-php

The Mailgun SDK provides methods for all API functions.

1.1k28.9M168](/packages/mailgun-mailgun-php)[laravel/nightwatch

The official Laravel Nightwatch package.

3486.1M13](/packages/laravel-nightwatch)[theodo-group/llphant

LLPhant is a library to help you build Generative AI applications.

1.5k311.5k5](/packages/theodo-group-llphant)[opensearch-project/opensearch-php

PHP Client for OpenSearch

15024.3M65](/packages/opensearch-project-opensearch-php)[flow-php/flow

PHP ETL - Extract Transform Load - Data processing framework

81733.7k](/packages/flow-php-flow)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
