- What's new
Easier and Faster Implementation with Our Updated SDKs
We’ve made several performance and stability enhancements to our API recently. Because of the significance of the changes and also to keep our API consistent, we’re changing the default base URL to /v3.
https://api.mailgun.net/v3/
No need to change your endpoints. All existing API methods remain backward compatible and keep the same request/response format. However, there will be some behavioral changes in a few of them.
We made some significant changes to our suppressions API, which manages your bounces, unsubscribes and complaints.
Everything mentioned below for “bounces” is true for “unsubscribes” and “complaints” as well.
The current GET /v2/<domain>/bounces
method preserves the same request/response format but effectively becomes an alias for the Events API so will be able to return bounces occurred in the past 30 days only. Due to the way the Events API works, total_count returned via this API call will no longer be accurate and preserved for backward compatibility purposes only.
The new GET /v3/<domain>/bounces
method used for iterating over all domain’s bounces returns bounce addresses in alphabetical order, so can no longer be used for polling for the most recent bounces. It is also much faster and more stable than its /v2 counterpart when iterating over large lists.
The new batch upload method lets you upload many bounces in a single API call.
Tweaks to request/response formats of other suppressions API methods that make for cleaner API in general.
New suppressions API docs available here.
If you’re currently using /v2/<domain>/bounces
API to poll for most recently occurred bounces, you can continue using it but do not rely on total_count. If, however, you need to reliably pull all domain’s bounces, please use /v3/<domain>/bounces
API call.
Most of our customers should be unaffected by these changes. If anything you should experience a performance upgrade with our APIs. If this does affect you feel free to contact our Support team with any questions.
Happy Sending!
It's easy to get started. And it's free.
See what you can accomplish with the world’s best email delivery platform.
Last updated on September 16, 2020
Easier and Faster Implementation with Our Updated SDKs
The Difference Between SMTP and API
Mailpets: For The Love Of Animals
The Mailgun Maverick Program Is Here!
Force for Change: It's Time to Speak Out
When Should You Use An Email API?
4 Tips To Improve Your Email Deliverability In 2021
Mailgun’s COVID-19 Plan of Action
Inbox Placement - Delivery Made Simple
What we've been up to: Mailgun's 2019 Year in Review
Easier and Faster Implementation with Our Updated SDKs
We stand with the AAPI community
The Difference Between SMTP and API
The Basics of Email Dark Mode
COVID-19 Survey: How the Pandemic Has Affected Email Sending
Mailgun Validations Features Improved Performance for EU Customers
International Women’s Day: How Pathwire’s Female Leaders Choose To Challenge
The Top Email Clients and Email Apps of 2021
How To Build An Email List The Right Way
The Path To Email Engagement In 2021: Key Learnings
Easier and Faster Implementation with Our Updated SDKs
We stand with the AAPI community
The Difference Between SMTP and API
Preparing Your Email Infrastructure Correctly
4 Tips To Improve Your Email Deliverability In 2021
COVID-19 Email Communications Dos and Don’ts
How To Use Parallel Programming
Mailgun’s COVID-19 Plan of Action
Password Meters Are Not For Humans
Send Your Emails at the Perfect Time with Send Time Optimization
Always be in the know and grab free email resources!
By sending this form, I agree that Mailgun may contact me and process my data in accordance with its Privacy Policy.