Weekly product update: Domain-level webhooks and reputation system improvements

This week's main theme was webhooks and we've got an exciting (and much requested) new feature to announce: domain-level webooks. Read more...

This week’s main theme was webhooks and we’ve got an exciting (and much requested) new feature to announce: domain-level webooks. In addition, we’ve been focused on improving our reputation system to catch spammers and scammers before they can do their damage.

Domain-level webhooks

Until today, you could specify webhooks end points at the account level, but could not set different end points for different domains. Now you can!

Just as a reminder, the webhook notifications include:

  • Deliveries – email was accepted by the recipient email server

  • Bounces – email was not accepted and a hard bounce code/reason was returned

  • Drops – email was not accepted for reasons other than a hard bounce (excessive grey listing, incorrect mx records, etc.) and Mailgun stopped attempting to deliver

  • Opens – email was opened (and images were enabled)

  • Clicks – a link was clicked in the email

  • Unsubscribes – recipient unsubscribed from email distributions

  • Complaints – recipient clicked on their email client’s spam complaint button (note: not all ESPs provide this feedback)

Benefits of domain-level webhooks

Having spoken to a number of customers, we’ve identified the following use cases for having different webhook handlers for different domains:

  • You are using Mailgun to manage email for your own clients and you need to segregate client webhooks for processing

  • You use different domains for production and staging environments and want to use different sets of webhooks for them.

  • Load-balancing: some customers use many different email domains and process a lot of webhook calls. This gives them yet another way to distribute the load.

Configuring webhooks in the Mailgun control panel

There are no significant UI changes in the control panel. The only change is that now when you change the domain selector, you can add a different URL for that domain. Previously, there was no ability to add or change the URL per domain. If you were already using webhooks and you want to keep the old behavior, you do not need to do anything. We have migrated the URLs you were using appropriately.

Reputation system improvements

Unfortunately, when you are in the email business you have to spend a lot of time dealing with spammer and scammers. We have been working hard on our reputation system to improve the detection of bad email senders and bad traffic. The work is extensive so we’ll save the details for a separate blog post.

We take false positives very seriously but they may still occur. If you see your account is disabled, just send us an email at and we will work with you to resolve this ASAP.

Let's talk email

Learn about our deliverability services

See what you can accomplish with the world's best email delivery platform and experts at your disposal.

Happy emailing!


Related readings

Weekly product update: Geolocation in webhooks, custom variable support and more

There’s a lot going on at Mailgun, so we thought we would start publishing a list of updates each week, with the new features, bug fixes and improvements we’ve made.

Read more

Weekly product update: Manage your webhooks programmatically with new API

Mailgun released their webhooks beta for testing! Read more about how the beta went down here...

Read more

Same API, new tricks: Get event notifications just in time with webhooks

With this webhooks update, you have more choices to communicate with Mailgun and see the details of what’s happening with your messages.

Read more

Popular posts

Mailgun iconSee what you can accomplish with the world's best email delivery platform. It's easy to get started.Let's get sending
CTA icon Mailgun Icon