We all know that GitHub is the number one repository for developers who want to store their codes and project work. However, did you know that you can integrate Postman with GitHub and start saving your collections in the world’s largest host of source code? The new Postman pro-GitHub feature allows you to backup and syncs your Postman collections in a haven where you can access them whenever you like. In this write-up, we take you through a step-to-step process of adding your Postman collection to GitHub.
Contents
How to Backup your Postman Collection to GitHub
1. Visit the Postman website to view the available integration options
- Log on to the Postman app or website, and click on the dashboard icon.
- On the open dashboard window, look for the top right integration tab and click on it.
- Choose GitHub from the list of third-party integrations that appear once you hit the integration tab.
Once you click on the integration icon, a list of all integrations supported by Postman will be displayed. You just need to click on GitHub and proceed to the next step.
Once you click on GitHub in the integrations list, an add button will manifest at the far right. Click on it, and you’ll be prompted to log into your GitHub account by entering your credentials to grant Postman full access.
Once you click the add button, you’ll be required to enter your GitHub Personal Access Token to proceed.
After entering your token, hit the proceed button, and if it is verified, you can now go ahead and configure the integration.
3. Configure the Integration
Before you hit the submit button to push your Postman collection to the repository, you need to configure your GitHub account by doing the following:
- Choose the postman collection you want to back up from your database.
- Select an existing repository where you want your collection to go.
- Enter the directory that you prefer your collection to be pushed into. If there is no existing directory, it will be created automatically. If you fail to specify, the directory will be created as “Postman Collections” by default.
- Choose a name for the collection in the repositor.
- Specify the branch where you want the collection pushed. Like the directory name, a repository branch is also an advanced option. So, you can choose to enter the specific branch or let the collections to be pushed to the default branch – “master,” of the repository automatically.
4. Click ‘Submit’ to finish
Once you are confident that everything is appropriately configured, you’ll just need to hit the submit button, and your collection will be added to the GitHub repository. It will bear the name that you choose and saved as a JSON file in the location you selected.
The process of adding a Postman collection to GitHub is not that complicated. It is something that you can do in less than two minutes. Once you complete the integration, any change on your Postman collection will reflect automatically in the GitHub repository in real-time. However, you need to remember that only those on Postman paid plans can add or backup their collections to GitHub. So, if you are using the free version, this feature is not available for you.
Conclusion
Don’t risk losing the data in your Postman collections; back up your collections with GitHub using the new Postman GitHub integration feature and let your code and collections reside harmoniously in the same repository. If you have been looking for a way to back up your collections in GitHub, this article gives you a comprehensive procedure that you can follow.
How do you Export Postman Collection to OpenAPI?
If you’re looking to convert your Postman Collection to OpenAPI, check out APITransform. You can quickly convert your file in 4 easy steps:
- Go to APITransform.com & click “Upload Postman Collection”
- Fill out some basic information
- Upload your Postman Collection
- Click “Convert to OpenAPI”