Adding Bitbucket repositories to PullRequest

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 ever have any issues or questions about connecting with PullRequest, please reach out to support@pullrequest.com.

Step 1:

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 (ie - GitLab and GitHub) using the same PullRequest account. This can be done via the Account Integration page in user settings later.

Step 2:

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.

You'll be able to connect multiple Bitbucket entities if required. You can click here to access this page directly and add more.

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:

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

Step 4:

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.