azlobin/mautic-sendgrid-callback

Mautic plugin to process SendGrid Event Webhook callbacks for bounce and complaint handling.

Maintainers

Package info

github.com/AlexanderZlobinM1/SendgridCallBackBundle

Type:mautic-plugin

pkg:composer/azlobin/mautic-sendgrid-callback

Statistics

Installs: 3

Dependents: 0

Suggesters: 0

Stars: 0

Open Issues: 0

Security

Advisories: 0

Aikido package health analysis

v1.5.6 2026-02-25 19:33 UTC

Requires

MIT ec8eef35893955826f9f51ea30db7a45552dbebf

  • Alexander Zlobin

pluginsendgridwebhookMautic

This package is auto-updated.

Last update: 2026-02-26 10:28:16 UTC

README

Plugin for Mautic 5/6/7 to process SendGrid Event Webhook callbacks and mark contacts as Do Not Contact for email channel.

This plugin does not send email. Email sending is handled by Symfony's standard SendGrid mailer transport configured in Mautic.

Company: Sales Snap
Author: Alexander Zlobin

Supported mailer schemes

  • sendgrid
  • sendgrid+smtp
  • sendgrid+api

Processed events

The plugin handles these SendGrid event types:

  • bounce -> DoNotContact::BOUNCED
  • blocked -> DoNotContact::BOUNCED
  • dropped -> DoNotContact::BOUNCED (or UNSUBSCRIBED when reason indicates unsubscribe/spam)
  • spamreport -> DoNotContact::UNSUBSCRIBED
  • unsubscribe -> DoNotContact::UNSUBSCRIBED
  • group_unsubscribe -> DoNotContact::UNSUBSCRIBED

All other events are ignored.

Installation

  1. Install via Composer:
composer require azlobin/mautic-sendgrid-callback

Or copy plugin directory to your Mautic installation:

cp -R SendgridCallbackBundle /path/to/mautic/docroot/plugins/

Or install from ZIP by extracting SendgridCallbackBundle into:

/path/to/mautic/docroot/plugins/SendgridCallbackBundle
  1. Reload plugins and clear cache:
php bin/console mautic:plugins:reload
php bin/console cache:clear
  1. Configure SendGrid Event Webhook endpoint:
https://mautic.example.com/mailer/callback
  1. Enable at least these events in SendGrid Event Webhook settings:
  • Bounce
  • Blocked
  • Dropped
  • Spam Reports
  • Unsubscribes
  1. Open plugin card in Mautic Plugins and configure settings directly in plugin modal.

Use the available safe controls (switches/select) to enable/disable event processing and choose dropped-event mapping policy (auto, bounced, unsubscribed).

Notes

  • The plugin tries to extract X-EMAIL-ID from custom_args or unique_args in webhook payload to link callback to email ID.
  • If X-EMAIL-ID is missing, callback still marks contact by email address.