Product

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...

PUBLISHED ON

PUBLISHED ON

Recently, we’ve been working on our newest API to make it easier for customers to automate their email. After working with a select set of alpha customers, today we’re ready to extend the API to a larger group of beta testers. So, say hello the Domains API.

Using multiple domains in your Mailgun account

Many of our customers are buildings 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 whitelabel 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 repuation, 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 our 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 programatically 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

Will there be a charge for using the domain’s API?

We are still finalizing pricing for when the Domains API is released in general availability, but our current thinking is to charge a reasonable per-domain fee. We welcome feedback on this and we will keep our beta-testers well informed of the final pricing details prior to general availability.

How can I try out the new Domains API?

If you want to test out the Domains API, or provide feedback on anything else, just email domains-api@mailgun.net. We’ll give you access and give you the documentation so you can start managing your own domains programmatically.

Please let us know what else you would like to see in the Domains API and thank you to everyone who has already provided feedback.

Happy emailing, The Mailgunners

Related readings

Here’s how to track email opens in Gmail with email tracking

Sending email campaigns doesn’t have to feel like you’re throwing darts into a black hole. Email analytics are a great way to determine the health of your ecommerce campaign and...

Read more

Everything you need to know about sending email with APIs

Are you creating an e-commerce web page that needs to send transactional emails to customers? A developer building a web application that needs to send messages to email...

Read more

A practical guide to using Mailgun’s webhooks

Transactional emails are essential for most apps. We send welcome emails, password...

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