Adding Bitbucket Repositories

NOTICE: As of 2/13/2018, PullRequest requires an installation of the PullRequest Bitbucket app in lieu of assigning a pull request to the @PullRequestBot Bitbucket account.

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 support@pullrequest.com.

Step 1: Authorize and Connect

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

NOTE: You can authorize with multiple version control hosting providers (i.e., GitLab and GitHub) using the same PullRequest account. This can be done via the Account Integration page in your user settings.

Select Bitbucket as your provider during signup

Step 2: Install PullRequest in BitBucket

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

Bitbucket requires you to Enable Development Mode for your app to install the Pull Request application.

Once enabled, go back to the connect bitbucket page to install the application. NOTE: We take security very seriously at Pull Request. Check out our Data Security Policy and please email us at support@pullrequest.com if you have questions.

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 add-on.

Reach out to an administrator of the Bitbucket Team with this link and ask them to install the PullRequest add-on. (NOTE: You maintain full control of revoking PullRequest access at any time)

Step 3: View Repositories

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

Step 4: 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 team.

NOTE: Bitbucket UI elements may change without notice. If you have any questions or need any help, please email support@pullrequest.com.

Open your Bitbucket Team and select Members from the options sidebar. Then click the Manage team tab.

The Settings -> User Groups view should appear. Click the Add member button.

This will open a modal for adding team members.

In the Email field, add: bitbucket@pullrequest.com

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 your organization has configured Bitbucket.

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 support@pullrequest.com if you need this expedited or run into any issues.