DEV Community

Cover image for Stop Rebuilding Postman Collections from Scratch. Use Raw URLs from GitHub Instead.
Jeffrey Bulanadi
Jeffrey Bulanadi

Posted on

Stop Rebuilding Postman Collections from Scratch. Use Raw URLs from GitHub Instead.

Quick story on why I wrote this.

I got assigned to a handover project with a lot of API work. No API docs, no Postman collections, nothing. Just the project files.

So I built my own Postman collection. Then a second dev joined and did the same. Then a third.

Everyone had their own copy. Nobody was in sync.

The Fix

If your team stores collections in Azure DevOps or GitHub, there's a simple way to share them through Postman using Raw URLs.

What the guide covers

  • Export a Postman collection properly. Only properly exported JSON files work with Raw URL imports.
  • Structure your repo for Postman. Keep a /postman folder with your collection files.
  • Import using Raw URLs from GitHub. Click Raw, copy URL, paste into Postman. Fastest method.
  • Import by downloading the file. Works offline if raw URLs are restricted.

Part 1 of 3

  • Part 1 (this one): Import using Raw URLs
  • Part 2: Connecting GitHub directly to Postman
  • Part 3: CI/CD automation with the Postman API

Full guide with screenshots: learnbeyondbc.com

How does your team share API collections? Would love to hear what works for you.

Top comments (0)