# Bitbucket Cloud Integration

## 1. **Create an Atlassian API token**

1. Navigate to [Atlassian Account – Security → API tokens](https://id.atlassian.com/manage-profile/security/api-tokens). 
2. Click **Create API token with scopes**.

<figure><img src="https://3582076375-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MGIlBSTjQtZxUoFwUx4%2Fuploads%2Fh524BlARiZzZyGDnDJl7%2Fimage.png?alt=media&#x26;token=a82214e4-6212-4fe9-a397-4740cd218de3" alt=""><figcaption></figcaption></figure>

3. Name your token and choose an expiration date.

<figure><img src="https://3582076375-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MGIlBSTjQtZxUoFwUx4%2Fuploads%2FBpqZbCdKsrmw3d7BGVpY%2Fimage.png?alt=media&#x26;token=6778f45a-b488-458b-b133-dfec6697c9de" alt=""><figcaption></figcaption></figure>

4. Select Bitbucket from the app list.

<figure><img src="https://3582076375-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MGIlBSTjQtZxUoFwUx4%2Fuploads%2FseoUs61pNEUTvc8L2g4T%2Fimage.png?alt=media&#x26;token=4498ea9b-1563-484c-a32f-645fd3d15025" alt=""><figcaption></figcaption></figure>

5. Select the scopes as shown below:<br>

<figure><img src="https://3582076375-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MGIlBSTjQtZxUoFwUx4%2Fuploads%2FZw5lo2mvHEu6kpIvBf1z%2Fimage.png?alt=media&#x26;token=bf6dbe96-78b6-448c-81ec-c755d97d81ec" alt=""><figcaption></figcaption></figure>

6. Review the token and complete the token creation process.

## **2. Install Bitbucket Cloud Addon on Oobeya** :jigsaw:&#x20;

1. Log in to Oobeya with an *Administrator* account.
2. Navigate to **Integrations** and select the **Bitbucket Cloud** addon and then click the **"Install"** button.&#x20;

![](https://3582076375-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MGIlBSTjQtZxUoFwUx4%2Fuploads%2FiWUd4zkEzp4eC4INBo6p%2FScreenshot%202024-12-17%20at%2011.02.58.png?alt=media\&token=e5ef7d4c-e6c6-4cc1-8eb0-34dd0820a5af)

## **3. Add A New Data Source** :electric\_plug:&#x20;

1\. Navigate to **Data Sources**, and select Bitbucket Cloud to add a new data source.&#x20;

![](https://firebasestorage.googleapis.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MGIlBSTjQtZxUoFwUx4%2Fuploads%2FR6StYegMSpYq1AvucXED%2Ffile.png?alt=media)

2\. Click the **"New Data Source"** button and fill in the form by using the *API Token (instead of the App Password, which will be changed in the next release),* which was generated on Bitbucket Cloud in the first step.&#x20;

**Data Source Name:** A custom name for your data source (e.g., "Bitbucket Cloud").&#x20;

**Username:** E-mail account used for Atlassian.

**App Password:** API Token created in the previous steps.

**Workspace:** Your workspace on Bitbucket Cloud.

<figure><img src="https://3582076375-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MGIlBSTjQtZxUoFwUx4%2Fuploads%2FYyIGfAYI8ySsSXnYoDSh%2Fimage.png?alt=media&#x26;token=b04f67d4-53ed-4dea-81a4-659ff9652f50" alt=""><figcaption></figcaption></figure>

3\. Click the **"Test Connection"** button to verify the connection.

## **Ready to Connect** :rocket:&#x20;

Now Oobeya is connected with your own Bitbucket Cloud account to get the real-time statistics of your code repositories to track each development activity.

## **Next Steps** :dart:&#x20;

* [Add a new Widget](https://docs.oobeya.io/dashboards/adding-a-new-widget)
* [Create a new Gitwiser Analysis](https://docs.oobeya.io/gitwiser-repo-analytics/settings-for-git-analytics/initialize-development-analytics)