Together at Last: Postman Meets Mailgun
Written by Michael Kane
Categories: Email DIY
2 minute read time
Mailgun has, and always will be, an email service for developers. No matter the development environment or programming language you’re comfortable in, we’ve got libraries for that. We’re all about adapting and providing a better service, and that means flexing our more front-end capabilities too. That’s why we’ve made sure that you can use Mailgun in Postman.
Wait a minute, what’s Postman?
Postman is for the people in your company that have an interest in exercising a REST-based API but aren’t comfortable with setting up a development environment, are confused by parameters, or have an episode of Westworld to watch and they might not have time to learn cURL. Postman makes APIs approachable by integrating them in a graphical interface.
APIs can be daunting to someone who isn’t familiar with them, and that can turn people away who should otherwise know more about them and how they play a role in their app or business. Postman empowers those people to feel like a programmer with programmer adjacent features like being able to set up environments that you can easily switch APIs between.
TL;DR – Postman makes your environment a little more user-friendly and helps non-programmers gain a little bit of programming understanding.
Now if you get what we’re saying and already have Postman, click the button below and go on your way. It includes a Mailgun-specific environment so that you can plug in the following few items and be in business:
- API_KEY – found in the console under Account – Security
- BASE_URL – US by default; simply change to https://api.eu.mailgun.net/v3 for EU
- mydomain – many of our API endpoints have the domain in the request, so paste in your domain here
- token – leave this guy alone entirely!
Done! You’re off and running! Go ahead and give the Get domains API a try – it’s ready to go without any further parameters.
Edit: The button above was intended to include the Mailgun Postman API but was not importing correctly. Instead, download the environment’s JSON from this link and then import the environment. Do this by hitting the sprocket in the upper-right hand corner of the Postman UI, hit the Import button, and browse for the downloaded file.
If Postman is sounding a little confusing, don’t worry! We’re going to walk you through downloading Postman and how to set it up. First, go ahead download Postman. Click the button below to import the Mailgun collection into Postman, or click this link and import as demonstrated below:
Then, go fetch your API key from the dashboard:
Also, go ahead and grab the domain you will be querying on:
Paste both your API key and Domain into the Mailgun Postman Environment, demonstrated below:
Finally, make your first request! Expand the collection, expand Domains, and hit Get domains. Then, click Send.
We hope you enjoy using Mailgun in Postman and show it to some of your coworkers who want to get their feet wet with our API. Hopefully, they feel a little less intimidated about APIs and gain a better understanding about what you do instead of giving you a blank stare when you bring up the topic. We’re really excited about it – like geeking out over Westworld spoilers excited. If you end up doing something really impressive with Mailgun and Postman, tweet at us! We’d love to see your work.
Modified on: March 13, 2019