This guide will assist you in effectively integrating CodeRabbit with Bitbucket Cloud.

To enable CodeRabbit to interact with your Bitbucket repositories, anapp password is required. This token grants the necessary permissions for interacting with the Merge Requests and Discussions APIs.

To enable CodeRabbit to interact with your Bitbucket repositories, anapi token is required. This token grants the necessary permissions for interacting with the Merge Requests and Discussions APIs.

1. Create a new Bitbucket account specifically for CodeRabbit and treat it as a service account.

2. Name the account "CodeRabbit".

3. If your Bitbucket workspace requires two-step verification, then you must also enable two-step verification on this new account.

4. Generate anApp Password to enable seamless integration between CodeRabbit and your Bitbucket repositories.

4. Generate anApi Token to enable seamless integration between CodeRabbit and your Bitbucket repositories.

We recommend creating a new user as a service account, associating this user to the workspace you'd like to install CodeRabbit on, and providing CodeRabbit with the app password to allow access. During the installation process, CodeRabbit will automatically configure the required webhook for seamless integration.

<divclass="center-image">

<img

src="/img/integrations/bitbucket-app-password-modal.png"

alt="Bitbucket user modal"

width="1000"

/>

</div>

We recommend creating a new user as a service account, associating this user to the workspace you'd like to install CodeRabbit on, and providing CodeRabbit with the api token to allow access. During the installation process, CodeRabbit will automatically configure the required webhook for seamless integration.

If you wish to change the review user, you must provide theapp password for the new user who will post reviews and comments. However, this requires manually removing the previous user from the projects and associated webhooks. Once this is done, you will need to reinstall the CodeRabbit app for each project.

If you wish to change the review user, you must provide theapi token for the new user who will post reviews and comments. However, this requires manually removing the previous user from the projects and associated webhooks. Once this is done, you will need to reinstall the CodeRabbit app for each project.

- Code reviews will be attributed to the owner of theapp password.

- Code reviews will be attributed to the owner of theapi token.

Bitbucket provides an option to generate anapp password for a new user. Follow these steps to generate thepassword:

Bitbucket provides an option to generate anapi token for a new user. Follow these steps to generate thetoken:

1. Log in using the user designated for CodeRabbit reviews. This user serves as a service account for managing reviews and related activities.

2. Go to"Personal Bitbucket Settings".

3.Choose**App passwords**.

4.Click**Create app password**.

2. Go to["API Tokens Settings"](https://id.atlassian.com/manage-profile/security/api-tokens).

3.Click**Create API token with scopes**.

4.Enter a name easily recognizable for this api token usage and an expiration date based on your plan of using the product.

6. Ensure the following scopes are selected:

1. Account - Read

2. Issues - Write

3. Workspace membership - Read

4. Projects - Write

5. Repositories - Write

6. Pull requests - Write

7. Webhooks - Read and write

8. Pipelines - Read

9. Runners - Read

7. Click**Create**

8. Note down theapp password as it will only be displayed once.

8. Note down theapi token as it will only be displayed once.

<divclass="center-image">

<img

src="/img/integrations/bitbucket-app-password-page.png"

alt="Bitbucket app password configuration page"

/>

</div>

<divclass="center-image">

<img

src="/img/integrations/bitbucket-app-password-permissions.png"

alt="Bitbucket app password permissions"

src="/img/integrations/bitbucket-api-token-scopes.png"

alt="Bitbucket API token scopes"

width="1000"

/>

</div>

By default, if noapp password is provided, CodeRabbit will prompt you to provide one during the installation process. However, if you wish to provide the token beforehand, you can do so by navigating to the**Organization Settings** tab, and selecting the**Bitbucket User** tab on the sidebar. Once entering theapp password, thepassword will be validated and saved for future use.

By default, if noapi token is provided, CodeRabbit will prompt you to provide one during the installation process. However, if you wish to provide the token beforehand, you can do so by navigating to the**Organization Settings** tab, and selecting the**Bitbucket User** tab on the sidebar. Once entering theapi token, thetoken will be validated and saved for future use.

You can confirm the correct user is being selected by verifying the user ID shown on the UI with the user ID of the service account user you created.

Then refresh the repository page in the CodeRabbit app and you can reinstall the webhook.

If you cannot install the webhook please check that your Bitbucket user has the necessary permissions to install the webhook and theApp Password is properly configured.

If you cannot install the webhook please check that your Bitbucket user has the necessary permissions to install the webhook and theApi Token is properly configured.