Back Up and Sync Your Postman Collections to GitHub
Millions of developers use GitHub every day to manage and store revisions of projects, making it the largest host of source code in the world. Now you can easily backup and synchronize your Postman Collections on GitHub. Your Collections are all tucked in safe and sound with our latest Postman Pro to GitHub Integration.
If you have 2 minutes, we’ll show you how right now.
Back up your Postman Collections to GitHub
Log on to your Dashboard from the Postman website, and navigate to the Integrations page to see a list of all the currently available integrations for Postman Pro users.
Select the Integrations tab.
Select GitHub from a list of Postman’s 3rd party Integrations for Postman Pro users.
Click Add to backup your Postman Collections to GitHub, and then log in with your GitHub credentials to authorize Postman to access your GitHub account.
Select an existing GitHub repository, select an existing Postman Collection, and then enter a filename to call your backup. Upon submit, your Collection will be pushed to your GitHub repository under the filename that you specified, and saved as a single JSON file.
There are also some advanced options available. You can enter a custom directory name, or leave “Postman Collections” as the default. You can specify a branch for commit, or leave “master” as the default.
And that’s it! From now on, every change saved to your Postman Collection will automatically commit changes to your GitHub repo in real time. Now your Collections and code can live together in perfect harmony in the same repository.
Explore this one and other 3rd party Integrations on the Postman Integrations directory, and let us know what you think!
Nooice
Is there a way to use GitHub to review a Postman collection in a better readable format than JSON?
If you choose to maintain your Postman collection in GitHub, then it will be in the JSON format. If you want to view the collection data in a Graphical User Interface, then obviously you would do that in the Postman app. Let me know if you had a specific use case in mind, for which there might be a better solution.
Is there a way to have a two way sync between Github and Postman. If multiple people across different orgs are collaborating on same collection, or if a user’s diff on github is accepted for enhancements to a given collection, what is the best way to incorporate those changes to the original collection on Postman?
Here’s one way to sync your collections bi-directionally between Postman and GitHub: https://medium.com/better-practices/git-hooks-for-automation-135c62bca7d7
And if you’re using API schemas: https://blog.postman.com/syncing-your-openapi-raml-and-graphql-schema-to-github-with-postman/
I think there must be a way here for public to be able to provide feedback via GitHub. There should be a sync between postman and GitHub not just a simple backup and restore.
Hi,
When selecting Integrations and then selecting create a Integration in this workspace I only get the “Backup collections and sync API schemas to your github repository”.
I do not see the option to only “Backup your Postman collections”.
Thanks,
Chris
with the horrible new update and layout, almost all of these posts are out of date. Form or function. Disappointing now.
Hi Craig, Our Learning Center has updated documentation. We’re always looking to improve, so please report specific issues to our GitHub repository here.
Any integration with Azure DevOps?
Check out the Azure DevOps integrations here, available on certain Postman plans: https://learning.postman.com/docs/integrations/available-integrations/azure-devops/
I would like to check if there is a way not to push every save to the repo but trigger it manually. I usually like to save my work frequently and this creates a quite long history of small individually not too meaningful changes.
Also it seems that every time I hit save there is a commit and push even without any change which could make the history with a couple of people quite long.
This blog walks through manual commits. However, the native workflow requires an API schema.
https://blog.postman.com/latest-updates-to-syncing-your-specs-with-collections/
Is there any way to integrate backup to GitHub with more than 11 collections?
We have around 25 collections and we would like to integrate them all to a GitHub repository.
But after 11 integrations the UI tells us that we reached our limit?
Please contact our support team at http://www.postman.com/support and they’ll be able to help you.