Skip to main content
Qodo works natively with Bitbucket Cloud, using a dedicated service account to post code review comments on pull requests. It relies on Bitbucket webhooks and native pull request workflows to deliver automated insights. You can configure Qodo for selected repositories or across your entire Bitbucket workspace. Configuration typically takes around 5 minutes. Once installed, Qodo automatically processes pull requests and delivers actionable insights, such as code reviews, descriptions, and improvement suggestions, directly within your Bitbucket workflow.

​
Prerequisites

Before you begin, ensure you have:
  • Access to your Qodo portal.
  • A Qodo environment set up for Bitbucket Cloud. If you’re unsure of your environment type, contact your Qodo Account Manager.
  • System administrator access to your Bitbucket workspace.
  • A dedicated Bitbucket account to use as a Qodo service account (for example, qodo@yourcompany.com).

​
Access the Bitbucket integration

1
Log in to your Qodo portal.
2
From the left-hand navigation menu, select Integrations.
3
Locate the Bitbucket card and click Add installation to launch the installation wizard.

​
Install Qodo on Bitbucket Cloud

1

Create a service account

Create a dedicated Bitbucket user to serve as Qodo’s service account. This account will be used to post code review comments on your pull requests.The following steps are completed in Bitbucket, not in the Qodo wizard. Once done, return to the wizard to continue.
Bitbucket wizard step 1 showing Create a service account with Add workspace members dialog
1

Invite the user

In your Bitbucket workspace, go to Settings → Access Management → User directory and invite the service account user using a dedicated email address (for example, qodo@yourcompany.com).
2

Accept the invitation

The invited user receives an email invitation to join the workspace. Accept the invitation.
Bitbucket invitation email showing You have been invited to join a workspace with Accept invitation button
3

Create the Qodo account

Complete the Bitbucket account setup for the service user.
Bitbucket account setup page for creating the Qodo service account
4

Select the user

In your workspace user management, locate and select the newly created Qodo user.
Bitbucket workspace Users admin page with the Qodo service account listed
5

Add to groups

Add the Qodo user to the appropriate workspace group to grant the required permissions.
Bitbucket Add Qodo to groups dialog with bitbucket-admins group selected
Complete the account setupOnce the account is set up, complete the following:
  1. In the wizard, click Download Qodo logo. Then in Bitbucket, go to the service account’s profile settings and upload the logo as the account’s avatar.
  2. Back in the wizard, select the Confirming account created checkbox to confirm the account is ready.
  3. Click Next.
2

Grant access

Qodo requires workspace-level OAuth access to connect to Bitbucket. You must be a Bitbucket workspace admin to complete this step.
Bitbucket wizard step 2 showing Grant access installation guide with workspace admin warning
  1. In the wizard, click Install Bitbucket App. This opens the Bitbucket OAuth dialog in a new tab.
  2. Review the requested permissions and click Grant access. You are redirected back to the wizard automatically.
3

Select repositories

Select the repositories where you want to enable Qodo.
Bitbucket wizard step 3 showing Select repositories with workspace tree and search bar
Use the search bar to find specific repositories, or browse the workspace tree. You can select individual repositories or the full workspace.
  • Click Setup to continue.
4

Check connection

Qodo automatically verifies the connection to your selected repositories.
Bitbucket wizard step 4 showing Check connection with successful installation confirmation
Once the verification is complete, a confirmation is displayed.
  • Click Continue to proceed.
5

Enable Qodo

Qodo is now enabled for the selected repositories.
Bitbucket wizard step 5 showing Review capabilities enabled with connected repositories confirmation
The confirmation screen shows the number of connected repositories and confirms that AI code review, auto rule generation, and codebase context are active.
  • Click Finish installation.
Qodo is now active on the selected repositories. You can return to this wizard at any time to add more repositories.

​
Verify the installation

1
Open a new pull request in one of the connected repositories and confirm Qodo is triggered automatically.
2
Add a comment using one of the supported commands:
  • /agentic_describe
  • /agentic_review
Qodo should respond with a review or PR summary directly on the pull request.

​
What’s next

View Using Qodo in PRs to learn about next steps and how to get the most out of Qodo.