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

The basics of email subdomains

Today, we’re happy to share that there’s a new, automated way to prepare your dedicated...

Read more

Learning to improve Gmail deliverability

The inbox is a crowded arena, but you can’t compete if you don’t even make the cut. Any email sender will tell you email deliverability is a key success indicator and a surefire...

Read more

Catch-all domain support is now available in email verifications

Here at Mailgun, our focus has always been on creating solutions that solve problems big...

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