Bitbucket Cloud setup

Below is a step-by-step guide on how to integrate with Bitbucket Cloud. You can connect your account using OAuth or an API token (Bitbucket no longer supports username and password authentication).

Bitbucket host permission requirements

Flow only requires read access to your repositories. Flow needs this permission to process the metadata used to generate our reports.

The account used to connect Flow to Bitbucket must have these read scopes:

• Repository

• Issue

• Pull Request

• Account

Create your integration

To create your Bitbucket Cloud integration:

1. Click Settings in the top navigation.

2. In the left navigation under Integrations, click Integrations.

3. Click Add integration.

4. Click Bitbucket Cloud in the Integration Provider list.

5. Optional: If you see the Direct Connection or Hybrid Connection, select one.

6. Next, select your integration method and authenticate with Bitbucket: API token or OAuth. In most situations, we recommend OAuth-based integrations.

OAuth

Connecting using OAuth is the preferred method to connect your repositories and import your data, including pull requests and tickets.

1. In the Add credentials tab, click Connect with OAuth.

2. If you're already logged in to your Bitbucket account, a dialog will prompt you to confirm access. If you're not already logged in, you'll be prompted to log in before authorizing the connection.

3. If your connection was successful, you'll see a success message.

4. When your authentication is successful, click Next to complete the setup of your integration.

API token

1. In the Add credentials tab, enter the email and Personal API token. For more information on where to create an access token in Bitbucket Cloud, see Bitbucket’s support document, Bitbucket API token.

Open

2. Click Test connection. If your connection was successful, you'll see a success message.

When your authentication is successful, click Next to complete the setup of your integration.

Finish your integration setup

Once you have a successful connection, you can finalize your integration and begin importing repos as outlined below:

1. Click Next from the Bitbucket Authentication Method screen.

2. Toggle the Repos, Tickets, and Pull requests services on or off to determine which data types Flow will ingest for this integration. After you've made your selections, click Next.

3. Name your integration. This is the name Flow will display for the integration. Choose a name that will help you identify the integration later. Then click Done.

When you've successfully created a new Bitbucket Cloud integration, you'll see a success message.

You've successfully created a Bitbucket Cloud integration. Next, Flow directs you to the integration's details page to complete additional setup steps. At this point, choose whether to enable auto-import for your repos and set up repo exclusions.

To learn more about managing your new integration settings, see Managing integrations.