Webhook Format

Every Mandrill webhook uses the same general data format, regardless of the event type. The webhook request is a standard POST request with a single parameter (currently) - mandrill_events.

There are three types of webhooks that Mandrill currently POSTs: Message webhooks (such as when a message is sent, opened, clicked, rejected, deferred, or bounced), Sync webhooks, and Inbound webhooks.

The mandrill_events parameter contains a JSON-encoded array of webhook events, up to a maximum of 1000 events. Each element in the array is a single event, such as an open, click, or blacklist sync event. For examples of each type of event and a description of the keys, select the type of events you'll be processing:

If your webhook URL is down or can't accept requests, see how Mandrill handles that here.



Only changes which remove or modify the expected behavior of existing parameters are considered backwards-incompatible. As a result, new keys may be added for webhooks without advance notice or versioning.