Download the PHP package azlobin/mautic-sendgrid-callback without Composer
On this page you can find all versions of the php package azlobin/mautic-sendgrid-callback. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Informations about the package mautic-sendgrid-callback
Mautic SendGrid Callback
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.
The Composer package installs the Symfony SendGrid Mailer bridge automatically. Configure the transport in Mautic with a sendgrid+api:// or sendgrid+smtp:// DSN after installation.
Company: Sales Snap
Author: Alexander Zlobin
Supported mailer schemes
sendgridsendgrid+smtpsendgrid+api
Processed events
The plugin handles these SendGrid event types:
bounce->DoNotContact::BOUNCEDblocked->DoNotContact::BOUNCEDdropped->DoNotContact::BOUNCED(orUNSUBSCRIBEDwhen reason indicates unsubscribe/spam)spamreport->DoNotContact::UNSUBSCRIBEDunsubscribe->DoNotContact::UNSUBSCRIBEDgroup_unsubscribe->DoNotContact::UNSUBSCRIBED
All other events are ignored.
Installation
- Install via Composer:
For an existing installation, update the package explicitly so Composer does
not keep an older version from composer.lock:
Or copy plugin directory to your Mautic installation:
Or install from ZIP by extracting SendgridCallbackBundle into:
-
Reload plugins and clear cache:
-
Configure SendGrid Event Webhook endpoint:
- Enable at least these events in SendGrid Event Webhook settings:
- Bounce
- Dropped
- Spam Reports
- Unsubscribes
SendGrid reports blocked deliveries through the Bounce event with
"type": "blocked"; it is not a separate SendGrid checkbox. The plugin has
its own Handle blocked events setting for this payload type.
- 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).
When the plugin is inactive, SendGrid webhook payloads are ignored and no Do Not Contact records are created or changed by this plugin.
Notes
- The plugin tries to extract
X-EMAIL-IDfromcustom_argsorunique_argsin webhook payload to link callback to email ID. - If
X-EMAIL-IDis missing, callback still marks contact by email address.
Release 1.5.10 attribution and retries
The plugin preserves Mautic email IDs in outgoing SendGrid API metadata and SMTP X-SMTPAPI.unique_args, merging existing metadata. It accepts top-level, custom_args and unique_args webhook formats, validates positive non-overflowing IDs, and warns when only contact-level DNC can be updated. bounce with type=blocked follows the existing blocked-event switch. Database failures now return HTTP 503 rather than silently acknowledging the event. See LINEAGE_AUDIT.md.
All versions of mautic-sendgrid-callback with dependencies
mautic/core-lib Version ^5.0 || ^6.0 || ^7.0
symfony/sendgrid-mailer Version ^5.4 || ^6.0 || ^7.0