Adding Bitbucket Repositories

This guide includes authorizing your Bitbucket account with PullRequest, authorizing repositories, and configuring the mechanisms for PullRequest to post review results to pull requests.

Step 1: Enable Bitbucket Cloud development mode for the PullRequest Bitbucket app

Integration with Bitbucket involves connecting to the PullRequest Bitbucket app (which is private, not listed in their public marketplace). First you'll need to add the PullRequest Bitbucket app descriptor to your Bitbucket Workspace.

You can do this by accessing:<YOUR_WORKSPACE_ID>/workspace/settings/addon-management

Or, open your Bitbucket Workspace and go to Settings -> Installed Apps (under the APPS AND FEATURES section).

Click the Install app from URL link and enter the following URL into App URL field:

Step 2: Authorize and Connect

After signing up, you'll be prompted to authorize and connect with a version control hosting provider. Click the Sync with Bitbucket option.

You'll be prompted by Bitbucket to grant access to your Bitbucket user account.

Step 3: Install the PullRequest Bitbucket app

After authorizing with your Bitbucket user account, you'll be directed to page in connect with the Bitbucket add-on. Select the Bitbucket Workspace you'd like to connect PullRequest with and click the Grant Access button.

If you're unable to grant access because developer mode is not enabled, make sure the setting is enabled for your Workspace (see step 1).

Q: I don't see the Bitbucket Team I need to add from the Bitbucket drop-down selector. How do I add it?

A: You may not have admin credentials to authorize the PullRequest Bitbucket app. Contact an administrator of your Workspace and have them install the application with from this link.

NOTE: You maintain full control of revoking PullRequest access at any time.

Step 4: View Repositories

Repositories should now appear on the PullRequest dashboard page when the Bitbucket Workspace is selected from the Organizations drop-down menu at the top-left portion of the screen.

Step 5: Add PullRequest posting user to your team

In order for PullRequest reviewers to post feedback in your Bitbucket pull requests, a PullRequest posting user must be added to your Workspace.

Open your Bitbucket Workspace and go to Settings -> User groups.

This can be accessed from:<YOUR_WORKSPACE_ID>/workspace/settings/groups

Then click the Add member button.

This will open a modal for adding team members.

In the Email field, add:

In the Groups field, apply any Bitbucket Group(s) with access to the repositories you'd like PullRequest to review for.

Usually the default group is Developers, but this varies depending on how roles are assigned in your Bitbucket Workspace.

If the PullRequest team member isn't added immediately (in an "Invitation Sent" state), it should be added within a few hours. Reach our to if you need this expedited or run into any issues.

NOTE: This guide contains screenshots from third-party partner interfaces that may be modified without notice. If you have any issues or questions about connecting with PullRequest, please reach out to

Last updated