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 [e-mail].

Step 1:

Login with Bitbucket or email address during signup. 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.

Select Bitbucket as your provider during signup

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.

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 [e-mail] 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:

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 [e-mail].

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: [e-mail]

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 [e-mail] if you need this expedited or run into any issues.