Back to main menu


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

When it comes to email sending, sometimes you need more than the press of a button to get your message across. You may have heard of email subdomains, but you may be...

Read more

An expanded Mailgun product suite to transform email deliverability

Today marks a special day for Sinch Mailgun. For over a decade, our focus has been to provide the best email experience for businesses all around the world. Now, we take...

Read more

Privacy, automatic engagements, and Mailgun’s bot detection

Now more than ever, users are concerned about their data privacy and what steps they can take to protect their personal information. And that’s something big players in the tech...

Read more

Popular posts

Email inbox.

Build Laravel 10 email authentication with Mailgun and Digital Ocean

When it was first released, Laravel version 5.7 added a new capability to verify user’s emails. If you’ve ever run php artisan make:auth within a Laravel app you’ll know the...

Read more

Mailgun statistics.

Sending email using the Mailgun PHP API

It’s been a while since the Mailgun PHP SDK came around, and we’ve seen lots of changes: new functionalities, new integrations built on top, new API endpoints…yet the core of PHP...

Read more

Statistics on deliverability.

Here’s everything you need to know about DNS blocklists

The word “blocklist” can almost seem like something out of a movie – a little dramatic, silly, and a little unreal. Unfortunately, in the real world, blocklists are definitely something you...

Read more

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