Weekly product update: Say hello to the Domains API

Mailgun officially released our Domains API to make it easier to build large-scale email systems on top of Mailgun. Read more...



Posted on October 25, 2013.

We’ve been quiet for a couple weeks but we have something extra exciting to share today: we’ve just officially released our Domains API to make it easier to build large-scale email systems on top of Mailgun.

Why would I need a domains API in the first place?

Many of our customers are building applications on top of Mailgun that allow their end customers to send email. Since you can operate multiple domains in a single Mailgun account, one of the things these customers can do is isolate one customer from another so that they each have their own white-label domain, their own sending queue, and their own SPF & DKIM records. Each customer’s sending reputation is also isolated, so if one customer gets the bad idea to buy an email list and send out spam, Mailgun can disable just that domain to protect your reputation, leaving other customers unaffected.

If you don’t want to give each customer their own domain, you could create buckets of domains for customers and manage reputation isolation that way. For example, you can have one domain that you use to send out your own transactional email and three buckets for your customers that you want to isolate. For example:

  • My transactional email: “”

  • My new customers: “”

  • My verified transactional customers: “”

  • My verified bulk sending customers: “”

Before the Domains API, each of these domains had to be created manually through the Mailgun control panel. That’s ok if you only have four domains like in this example, but what about if you have 4000? That’s a lot of clicking. Enter the Domains API…

Create and manage domains programmatically with the Domains API

With our newest API, you can do the following programmatically:

  • Retrieve list of domains: Returns list of domains under your account in JSON.

  • Retrieve details about a particular domain: Returns details for a single domain, including SMTP credentials and DNS records.

  • Create a new domain

  • Delete a domain

View the full Domains API guide

Is there a charge for using the Domains API?

No, the Domains API is free to use and each Mailgun account can have up to 1000 domains. If you need more than 1000 domains, let us know so we can discuss a plan that works for you.

Happy sending, The Mailgunners

Related readings

Weekly product update: Try our new domains API, now in private beta

While the domain API beta launch is long closed, read more to see how we implemented this launch. Read more...

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

Weekly product update: Validate DNS records using the Domains API

A quick update detailing the DNS record validations going on in the Domains API in Beta. Read more –

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