Product

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: “myapp.com”

  • My new customers: “subnet1.myappmail.com”

  • My verified transactional customers: “subnet2.myappmail.com”

  • My verified bulk sending customers: “subnet3.myappmail.com”

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

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

The basics of email subdomains

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

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
Milgun-Icon