Integrate Postman with Bitbucket

You can back up your Postman Collections to your Bitbucket repository. Once the integration is configured, any changes to your collection in Postman will also appear in your Bitbucket repository.

API sync with Bitbucket

With Postman v10, you can connect a Bitbucket repository to an API in the API Builder. Once connected, you can sync your API's definition and associated collections between Postman and Bitbucket. You can switch branches, pull changes from the repository, and push changes to the repository, all from within Postman. To learn more about syncing your API with Bitbucket, see API version control overview.

Backing up collections on Bitbucket

To back up your collections to a Bitbucket repository, do the following:

  1. From the Home page, select Integrations.

    Home page and integrations
  2. Select Browse All Integrations.

  3. Search and select Bitbucket.

  4. Next to Backup a collection, select Add Integration.

    Bitbucket details page
  5. Enter your Bitbucket authentication and select Authenticate and Proceed.

    App passwords are different from account passwords. Learn how to create an app password in Bitbucket.

    Add Bitbucket integration
  6. Select your collection to back up, the repository you'd like to back it up to, and choose the directory, filename, and branch. Select Add Integration.

    Configure Bitbucket integration

Postman often checks your collection for changes. If Postman identifies changes when it checks your collection, the changes automatically commit to your repository in JSON format.

To view your collections in Bitbucket, go to your Bitbucket dashboard > Repositories. Select your repository, then select Commits.

Bitbucket commits list

You can select a commit to view your stored collection in JSON format.

Bitbucket collection

You can view your configured integrations on the Browse Integrations page. You can also view integrations that have been configured for a collection by opening the collection and selecting the information icon Information icon in the right sidebar. Learn more about viewing or editing integrations.

Last modified: 2023/10/04


Postmanaut dancing. Illustration.