Connect a GitHub repository to your collection

Connect a GitHub repository and branch to your collection and collaborate with your team on your collection's releases. For example, connect your repository's primary branch to your collection, fork that collection in Postman, and collaborate with your team on your collection's next release.

Connect a GitHub repository and branch to your collection

Before you get started, create your repository and primary branch.

To connect a GitHub repository and branch to your collection, do the following:

1. Open your collection.

2. Next to your collection, click View more actions. Then, click More > Connect repository.

3. Choose where you host your repository:

   • If you choose GitHub, Postman asks you to authenticate. Follow the onscreen instructions.
   • If you choose GitHub Enterprise Server, Postman asks you for your GitHub domain. Enter or select it, and click Authenticate. Then, follow the onscreen instructions.

4. Select an organization.

5. If you don't see your organization, you may need to install the GitHub App to your organization first. To get started, follow the onscreen instructions.

6. Select a repository and branch.

7. (Optional) Enter a directory path for your collection file.

8. Click Connect.

Postman creates a collection file in the connected repository and branch. The collection's file name is the collection ID. Each time you save your collection in Postman, your changes are committed to the connected GitHub repository and branch.

To start collaborating on your next release, see Collaborate on your collection's release.

Disconnect a GitHub repository and branch from your collection

If you want to connect a different repository or branch to your collection, or need to troubleshoot your connection, you can start by disconnecting GitHub from your collection.

To disconnect a GitHub repository and branch from your collection, do the following:

1. Open your collection.
2. Next to your collection, click View more actions. Then, click More > Disconnect repository.
3. Enter your collection's name. Then, click Disconnect repository.

Your collection is no longer connected to the GitHub repository and branch.