The (new) fastest way to get started with Postman and Box

Cristiano Betta
Feb 10 · 3 min read
Image for post
Image for post
Postman & Box

We are pleased to announce a brand new way to use Box with Postman. We’ve launched a brand new version of our Postman collection and a new quick-start guide that makes it possible for anyone to get started with Postman and Box in less than 10 minutes.

A smarter Postman collection for Box

Image for post
Image for post
The Box Postman collection in action

The new collection is a lot smarter and a lot easier to keep up to date. It is automatically generated from our official OpenAPI specification and in simple terms this means that any time we launch a new API feature the Postman collection will be automatically updated to reflect these changes.

To make the collection a lot smarter we’ve added the following cool new features:

  • Integrated support for automatically refreshing access tokens when they expire. More on that in a moment.
  • A new folder structure that groups API calls into folders by topics, making it easier to find the right API endpoints.

Getting started in under 10 minutes

When we set out to overcome this hurdle we gave ourselves a goal of enabling anyone on Postman in under 10 minutes. The result of this challenge is our new Postman Quick Start guide.

The Postman Quick Start guide that gets users started in under 7 minutes!

The Postman Quick Start guide takes a user through the essential steps to set them up for using Postman with Box.

The quick start helps a user to:

  1. Install the Postman app
  2. Set up a Box app
  3. Authenticate themselves with that Box app using OAuth 2.0
  4. Load the Postman collection into the Box app
  5. Load their API credentials into Postman as an environment

At the end of the guide users have their Postman app set up and ready to make API calls to Box without any further configuration.

Image for post
Image for post
An example of a fully configured Postman environment

A better way to refresh API credentials

Image for post
Image for post
The environment variable used to auto-refresh the API credentials

In the new Box Postman collection we’ve added a way for the access token to be automatically updated whenever it expires. As long as the enable_auto_refresh_access_token value is set to true, and the refresh_token value is less than 60 days old, the access token will be automatically refreshed whenever it expires.

For users who’d rather perform this refresh manually we’ve also added an alternative way to do this as well.

Feedback welcome

A feature we’re looking to add soon is to re-introduce some variations of API endpoints that will provide users with ready-made versions of existing requests to perform some specific tasks like creating app users, managing shared links, and moving files and folders.

Box Developer Blog

News and stories for working with the Box APIs

Cristiano Betta

Written by

Senior Developer Advocate 🥑 at Box 📦. Developer Experience Enthusiast. Codes in Ruby & JS. Addicted to open source software.

Box Developer Blog

News and stories for working with the Box APIs

Cristiano Betta

Written by

Senior Developer Advocate 🥑 at Box 📦. Developer Experience Enthusiast. Codes in Ruby & JS. Addicted to open source software.

Box Developer Blog

News and stories for working with the Box APIs

Medium is an open platform where 170 million readers come to find insightful and dynamic thinking. Here, expert and undiscovered voices alike dive into the heart of any topic and bring new ideas to the surface. Learn more

Follow the writers, publications, and topics that matter to you, and you’ll see them on your homepage and in your inbox. Explore

If you have a story to tell, knowledge to share, or a perspective to offer — welcome home. It’s easy and free to post your thinking on any topic. Write on Medium

Get the Medium app

A button that says 'Download on the App Store', and if clicked it will lead you to the iOS App store
A button that says 'Get it on, Google Play', and if clicked it will lead you to the Google Play store