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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.pullrequest.com/adding-bitbucket-repositories-to-pullrequest/master.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
