PHPackages                             druidfi/mautic-bounce-webhook-bundle - 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 & Notifications](/categories/mail)
4. /
5. druidfi/mautic-bounce-webhook-bundle

ActiveMautic-plugin[Mail & Notifications](/categories/mail)

druidfi/mautic-bounce-webhook-bundle
====================================

Handles mailer transport webhook callbacks for bounce and spam events in Mautic.

1.0(yesterday)01↑2900%[1 issues](https://github.com/druidfi/mautic-bounce-webhook-bundle/issues)GPL-3.0-onlyPHPPHP ^8.1|^8.2|^8.3

Since Aug 28Pushed yesterdayCompare

[ Source](https://github.com/druidfi/mautic-bounce-webhook-bundle)[ Packagist](https://packagist.org/packages/druidfi/mautic-bounce-webhook-bundle)[ RSS](/packages/druidfi-mautic-bounce-webhook-bundle/feed)WikiDiscussions main Synced today

READMEChangelog (1)Dependencies (1)Versions (3)Used By (0)

Mautic Bounce Webhook Bundle
============================

[](#mautic-bounce-webhook-bundle)

A Mautic plugin that handles mailer transport webhook callbacks for bounce and spam events. It processes incoming webhook payloads from email providers and automatically marks contacts as Do Not Contact (DNC) in Mautic.

Supported Providers
-------------------

[](#supported-providers)

- **Mailjet** — processes `bounce`, `blocked`, and `spam` events via the [Mailjet Event API](https://dev.mailjet.com/email/guides/webhooks/)

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

[](#requirements)

- PHP 8.1 or higher
- Mautic 5.x, 6.x or 7.x

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

[](#installation)

Run the following command in your Mautic root directory:

```
composer require druidfi/mautic-bounce-webhook-bundle
```

Then clear the cache and go to the **Plugins** page in Mautic to install or upgrade the plugin.

Configuration
-------------

[](#configuration)

Set the following environment variables in your Mautic `.env` or server environment:

VariableRequiredDescription`MAILER_BOUNCE_PROVIDER`YesThe active bounce provider. Currently supported: `mailjet``MAILER_CALLBACK_SECRET`NoA secret token to authenticate incoming webhook requests. If not set, all requests are accepted (not recommended for production).Example:

```
MAILER_BOUNCE_PROVIDER=mailjet
MAILER_CALLBACK_SECRET=your-secret-token
```

Webhook URL
-----------

[](#webhook-url)

Configure your email provider to POST webhook events to:

```
https://your-mautic-domain.com/mailer/callback?token=your-secret-token

```

Bounce Behaviour
----------------

[](#bounce-behaviour)

EventProvider behaviourMautic actionHard bounce`bounce` with `hard_bounce: true`Contact added to DNC (Bounced)Soft bounce`bounce` with `hard_bounce: false`IgnoredBlocked`blocked`Contact added to DNC (Bounced)Spam complaint`spam`Contact added to DNC (Unsubscribed)Adding a New Provider
---------------------

[](#adding-a-new-provider)

1. Create a class implementing `BounceProviderInterface`
2. Add it as a constructor argument in `BounceProviderRegistry`
3. Register it in the `$providers` array with a matching key
4. Set `MAILER_BOUNCE_PROVIDER` to the new key

License
-------

[](#license)

GPL-3.0-only

###  Health Score

42

—

FairBetter than 88% of packages

Maintenance100

Actively maintained with recent releases

Popularity2

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity49

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 50% 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

Unknown

Total

1

Last Release

1d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/4cd9c5f6ffd2d6019f8375ce471fd34395c78885b9b9cf22e9a97be47c875138?d=identicon)[back-2-95](/maintainers/back-2-95)

![](https://www.gravatar.com/avatar/3536fe4e73dd8cafb90fa31159f0c53e1d7cb3cc1a4ead04507c37d46bf2df09?d=identicon)[tvalimaa](/maintainers/tvalimaa)

---

Top Contributors

[![back-2-95](https://avatars.githubusercontent.com/u/1140272?v=4)](https://github.com/back-2-95 "back-2-95 (1 commits)")[![tvalimaa](https://avatars.githubusercontent.com/u/5573746?v=4)](https://github.com/tvalimaa "tvalimaa (1 commits)")

---

Tags

mauticmautic-pluginpluginemailMauticwebhookMailjetbounce

### Embed Badge

![Health badge](/badges/druidfi-mautic-bounce-webhook-bundle/health.svg)

```
[![Health](https://phpackages.com/badges/druidfi-mautic-bounce-webhook-bundle/health.svg)](https://phpackages.com/packages/druidfi-mautic-bounce-webhook-bundle)
```

###  Alternatives

[etailors/mautic-amazon-ses

Amazon SES Mailer Plugin for Mautic

595.0k](/packages/etailors-mautic-amazon-ses)[mautic/grapes-js-builder-bundle

GrapesJS Builder with MJML support for Mautic

5794.3k15](/packages/mautic-grapes-js-builder-bundle)[pabloveintimilla/mautic-amazon-ses

Mautic 5 plugin that provides Amazon SES as an email transport and callback to process bounces

452.4k](/packages/pabloveintimilla-mautic-amazon-ses)[firemultimedia/mautic-multi-captcha-bundle

This plugin brings Google's reCAPTCHA, hCaptcha, and Cloudflare Turnstile integration to mautic.

151.4k](/packages/firemultimedia-mautic-multi-captcha-bundle)

PHPackages © 2026

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