# Adding Bitbucket repositories to PullRequest

{% hint style="info" %}
**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.
{% endhint %}

*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:  <a href="#step-1" id="step-1"></a>

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](https://app.pullrequest.com/dash/user/settings/integrations) page in user settings later.

![Select Bitbucket as your provider during signup](https://2276445710-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LQoW9dAgZgk5WoYhwja%2F-M0zCRaaD8zwucAydniq%2F-M11BmuyHm50EmpoYrsp%2Fimage.png?alt=media\&token=70f1bcb9-4984-48bc-a20e-919064d28841)

## Step 2:  <a href="#step-2" id="step-2"></a>

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.

![](https://2276445710-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LQoW9dAgZgk5WoYhwja%2F-M0zCRaaD8zwucAydniq%2F-M11Cbjyhkm79RU5Vt6d%2Fimage.png?alt=media\&token=8e92902c-b417-46b8-bda1-64b25f2a69c4)

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

![](https://2276445710-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LQoW9dAgZgk5WoYhwja%2F-M0zCRaaD8zwucAydniq%2F-M11DhnhndYOu94ZWxTz%2Fimage.png?alt=media\&token=87cd68a3-16f1-4883-8ee3-e6e6398918ee)

Once enabled, go back to the connect bitbucket page to install the applicatio&#x6E;**.** \
\
**NOTE:** We take security very seriously at Pull Request. Check out our [Data Security Policy](https://www.pullrequest.com/security/) and please email us at **<support@pullrequest.com>** if you have questions.

![](https://2276445710-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LQoW9dAgZgk5WoYhwja%2F-M0zCRaaD8zwucAydniq%2F-M11F-BCXFPyXDkliLZg%2Fimage.png?alt=media\&token=89f4c2cb-4bcc-4dda-8c39-adfd6af8dc9c)

**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**](https://bitbucket.org/site/addons/authorize?descriptor_uri=https://www.pullrequest.com/bitbucket/descriptor\&redirect_uri=https://www.pullrequest.com/bitbucket/callback/landing) and ask them to install the PullRequest add-on. *(NOTE: You maintain full control of revoking PullRequest access at any time)*

## Step 3: <a href="#step-3" id="step-3"></a>

Repositories should now appear on the PullRequest [**dashboard**](https://app.pullrequest.com/dash/) page when the Bitbucket Team or Profile is selected from the drop-down at the top of the screen.<br>

![](https://2276445710-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LQoW9dAgZgk5WoYhwja%2F-M0zCRaaD8zwucAydniq%2F-M11JgjBBvXlJYXxzj8x%2Fimage.png?alt=media\&token=2cbc23ab-8886-4a6d-a6f9-1e2c8321f5d9)

## 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.

{% hint style="info" %}
**NOTE**: Bitbucket UI elements may change without notice. If you have any questions or need any help, please email **<support@pullrequest.com>**.
{% endhint %}

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

![](https://2276445710-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LQoW9dAgZgk5WoYhwja%2F-LbykTdGo6NwiXAtNMRI%2F-LbymjMZ8l9Wwc9GaE5p%2Fbitbucket-team-members.png?alt=media\&token=5227cc07-436b-4685-b5a5-9f4264961516)

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

![](https://2276445710-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LQoW9dAgZgk5WoYhwja%2F-LbykTdGo6NwiXAtNMRI%2F-LbynmVFC7vIz7eJcVrF%2Fadd-member-button.png?alt=media\&token=a19a4875-eaaa-47b9-9ff4-a3aeea84c536)

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.

{% hint style="info" %}
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.
{% endhint %}

![](https://2276445710-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LQoW9dAgZgk5WoYhwja%2F-LfepQK6JOCxYPlv7FMn%2F-LfeqQtb0-TnyuM8Hp2n%2Fadd-team-memeber-bitbucket.png?alt=media\&token=f3c4a7d6-c982-4351-81e9-0188d0b0c32e)