Knowledge Base/Webhooks/Webhooks Basics

Introduction to Webhooks

posted this on July 19, 2012 12:38 AM

Mandrill's webhooks allow your application to receive information about email events as they occur. You can configure and test webhooks using the Webhooks settings page in your account, or via the API.

Event types

Webhooks may be configured to send one or more of the following types of events:

  • Message Is Sent - message has been sent successfully
  • Message Is Bounced - message has hard bounced
  • Message Is Opened - recipient opened a message; will only occur when open tracking is enabled
  • Message Is Marked As Spam - recipient marked a message as spam
  • Message Is Rejected - message was rejected
  • Message Is Delayed - message has been sent, but the receiving server has indicated mail is being delivered too quickly and Mandrill should slow down sending temporarily
  • Message Is Soft-Bounced - message has soft bounced
  • Message Is Clicked - recipient clicked a link in a message; will only occur when click tracking is enabled
  • Message Recipient Unsubscribes - recipient unsubscribed

Click for a detailed description of the data format for webhook. Webhooks are batched, and POSTed roughly each minute.


Before Mandrill begins POSTing to your webhook URL, it will be verified first to ensure it exists.

Topic is closed for comments