# Integrate Bitbucket with Databox

Bitbucket is a Git-based code hosting and collaboration platform from Atlassian, used by development teams to manage repositories, review code through pull requests, and track work with built-in issue tracking. Connecting Bitbucket to Databox brings your repository activity into dashboards alongside your other engineering and business metrics, so you can monitor development velocity, track open issues and pull request volume, and share progress reports with stakeholders in one place.

## Connection

### Before you begin

### Step 1: Sign in to Bitbucket

To connect Bitbucket to your Databox account for the [first time](/add-a-connection) or with new credentials, sign in with your Atlassian account. Enter your **Email** and click **Continue**, or sign in using a **Passkey**, **Google**, **Microsoft**, **Apple**, or **Slack**.

If you've already established a connection, you can [reuse](/add-a-data-source) it to add new repositories, as long as those repositories are accessible with the existing connection's credentials.

bitbucket-sign-in-screen
### Step 2: Grant access to Databox

Review the requested permissions and click **Grant access** to authorize the connection.

bitbucket-confirm-access-screen
### Step 3: Select the workspace

After authorization, select the Bitbucket workspace you want to report on.

### Step 4: Select the repository

Select the repository within that workspace. Each repository is connected as a separate data source in Databox, so repeat the process to connect additional repositories.

## Resources

For comprehensive details on metrics, data availability, templates, specifications, usage guidelines, and other key information, refer to the resources listed below.

No. Databox requests read-only access to your Bitbucket data. No changes are made to your code, issues, pull requests, or repository settings. You can revoke access at any time from your Bitbucket account settings under **Apps and features > Authorized applications**.

Databox can access the repositories that are visible to the Bitbucket account used to authorize the connection. The workspace and repository are selected during the connection flow, and each repository is set up as a separate data source in Databox.

Databox requests team membership access as part of the workspace-level authorization scope. This allows Databox to identify which workspaces and workspace repositories the authenticated account belongs to, so the correct repositories can be listed during the connection flow.

 

Ask Genie
Get instant answers or help with your data using the in-app AI assistant.

Talk to an expert
For customers: Get help with your setup, strategy, or making the most of Databox.

Book a demo
New to Databox? See how it works and get guidance on getting started.

Send an email
Reach out to support for help with your account, data, or technical issues.