- Best Practices
When Should You Use An Email API?
We believe in giving our customers full transparency into what is happening with their emails. That is why we show our customers what is happening with each and every email that gets sent or received through Mailgun with Logs.
Recently, we’ve been working on improving log data by giving customers even more data and enhancing the experience of retrieving that data. Like almost all features at Mailgun, the first interface we build is the API, with the GUI to follow. We are pleased to announce the private beta release of our Events API, which will be the foundation for Logs and other reporting in the future.
So how did we improve on Logs?
Previously, we just had simple skip and limit parameters to specify which portions of the logs you wanted to fetch. This was cumbersome and resulted in poor performance characteristics. With the new Events API, we’ve provided parameters that allow you to specify a time period in addition to the ability to specify ascending or descending. We also provide URLs in the response for retrieving the next and previous pages, giving you the ability to easily traverse log data.
Previously, you could only fetch all of the log data within the specified skip and limit parameters. Then you’d have to filter the data on your side. The Events API allows for filtering the data by a bunch of additional parameters and the ability to combine expressions in order to create complex queries.
Previously, with the Logs API, we only included information that happens to your email until it is accepted by the recipient email server or dropped. You could get the other events through the Campaigns API but we thought it would better to include all events in one easy to use API. The Events API allows you to query for all events, including those that occur after delivery like opens, clicks, unsubscribes and spam complaints.
Free for you my friend. For free accounts, we retain events for 2 days. For paid accounts, we retain events for 30 days. If you need retention for longer than that, contact us to discuss your needs.
If you are interested in playing with the Events API, feel free to send us an email: events-api@mailgun.net with your github handle and we’ll give you access to the private docs.
We hope this release dramatically improves the experience of tracking your emails. Please provide any feedback!
Happy sending! Mailgunners
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 August 27, 2019
When Should You Use An Email API?
Inbox Placement - Delivery Made Simple
Together At Last: Postman Meets Mailgun
Same API, New Tricks: Get Event Notifications Just In Time With Webhooks
Mailgun Security Incident And Important Customer Information
FML, I Didn’t Send That! What To Do If Spam Gets Sent From Your Account
Lock It Down! Welcome, 2 Factor Authentication
FML, I Didn’t Send That! What To Do If Spam Gets Sent From Your Account
Introducing The 5 User Roles: Keep The Riffraff Out Of Your Mailgun Account
How Quickly Can Mailgun Process My Messages? Introducing The Rapid Fire Delivery SLA
Make Email Accessibility Your New Year’s Resolution
Sunset Policies: Allowing Unengaged Recipients to Ride Off into the Sunset
Email's Best of 2020
Catch-All Domain Support Is Now Available In Email Validations
The Best Time To Send Emails: Cracking The Code
Tips for Building Better Holiday Email Templates
Happy Festivus: Email Deliverability For The Holiday Season
The Basics of Email Subdomains
A Word of Caution For Laravel Developers
The Science and Art of Gmail Deliverability
Sunset Policies: Allowing Unengaged Recipients to Ride Off into the Sunset
Email's Best of 2020
Catch-All Domain Support Is Now Available In Email Validations
How To Improve Email Open Rates
Preparing Your Email Infrastructure Correctly
4 Tips To Improve Your Email Deliverability In 2020
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
Always be in the know and grab free email resources!
Mailgun is committed to protecting your privacy. Please read ourPrivacy Policybefore providing us with your details.