Box Postman collection updates

Rui Barbosa
Box Developer Blog
Published in
3 min readJul 2, 2024

Hey developers!

Working with the Box REST API can be a breeze with our handy Postman collections. These pre-configured bundles save you the time and effort of manually building requests, giving you a jumpstart on your Box development journey.

Stop wasting time building collections manually

There are two Box Postman collections available, each catering to different needs:

  • Box Platform API (Classic Collection): Ideal for beginners, this collection supports OAuth authentication with automatic token refresh.
  • Box Platform Advanced Collection: This powerhouse collection handles all Box application authentication modes (Developer, OAuth, CCG, and JWT) with automatic token refresh (except Developer tokens).
Box public collections in Postman

Both collections are available in English and Japanese for your convenience.

Effortless Setup: Get Started in Minutes

Classic Collection:

  1. Quick start guide: Our comprehensive guide walks you through everything: installing Postman, creating a Box application, forking the collection, and making your first API call. It even sets up a Postman environment for seamless authentication. [Link to Quick Start Guide]
  2. Video tutorial: Prefer a visual approach? Check out our video guide that demonstrates the setup process. [Link to Video Tutorial]

Advanced collection:

  1. Fork and customize: Simply navigate to our public workspace and import the collection into your own. The Utilities folder provides helper methods and instructions to streamline environment setup. [Link to collection]
  2. OAuth authorization (if needed): We’ve included clear instructions for authorizing your application for OAuth use.

Keeping the collections up-to-date

At Box, we believe in continuous improvement. Our API specs are constantly updated, and so are the Postman collections! Here’s how to stay ahead of the curve:

  1. Enable “Watch original collection”: This ensures you receive notifications when updates are available.
  2. Pull changes: With a single click, you can effortlessly integrate the latest updates into your collection.

New and exciting features? We’ve got you covered!

The collections are constantly evolving to reflect new Box features. For instance, the latest update includes the much-anticipated AI endpoint!

The new AI endpoint

Classic vs. Advanced: Choosing the Right Collection

Not sure which collection is for you? Let’s break it down:

  • Classic collection: Perfect for beginners or those primarily using OAuth.
  • Advanced collection: Ideal for developers requiring flexibility. It supports multiple authentication methods, users, and service accounts. You can create and switch between environments with ease for a streamlined workflow.

Both collections offer the same API endpoints, so the choice boils down to your specific needs.

Ready to streamline your Box development?

Grab the Postman collection that suits you best, and get started exploring the Box API today!

POST/CON 24

In May 1st 2024 we presented the advanced collection authentication at the Postman developer conference, discussing how we implemented the simultaneous authentication modes. Here is a video of the content of the presentation:

Thoughts? Comments? Feedback?

Drop us a line in our community forum.

--

--