> For the complete documentation index, see [llms.txt](https://docs.hivel.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.hivel.ai/integrations/scm/bitbucket/bitbucket-integration.md).

# BitBucket Integration

**What data does Hivel require access to?**

Hivel securely accesses the last 60-90 days of commits and pull requests from active repositories.

**Authorization Control**

We utilize Bitbucket's OAuth for secure login. You retain full control and can revoke access at any time via Bitbucket's authorized apps settings.

**Pre-requisites**

A service account with *write* access to all applicable Bitbucket repositories.Write access is essential for publishing webhooks, enabling real-time data synchronization.

**Sign in to Hivel**

1. Navigate to the Hivel [<mark style="color:purple;">sign-up page</mark>](https://app.hivel.ai/signup)
2. Add your work email id (If you'd like to use your personal email id please contact [<mark style="color:purple;">support@hivel.ai</mark>)](mailto:support@hivel.ai\))
3. Now, you can use your Google or Microsoft login with your work email id; or create a password.
4. Create your Company Profile, and click '**Get Started**'.
5. Once you've successfully created your Company Profile you will be redirected to the Integrations Page.
6. Select Bitbucket, and log in to your company's Bitbucket account using a service account.
7. Authorize Hivel on the ensuing Bitbucket redirect.
8. Click "Grant" for desired workspaces.
9. After authorization, you'll be redirected back to Hivel.&#x20;
10. Once your Bitbucket is successfully integrated, we will start to pull data. It will take between 2 - 48 hours for the complete sync, depending on the volume of the data.

#### Below are step-by-step screenshots of instructions you can refer to if needed:

<figure><img src="/files/G1E2v4p9thZizxDJuNey" alt="" width="375"><figcaption></figcaption></figure>

<figure><img src="/files/Fw0xoTnojx7GlwFPSlFb" alt="" width="375"><figcaption></figcaption></figure>

<figure><img src="/files/IWo7f4kTNZvdEneoGZBR" alt="" width="375"><figcaption></figcaption></figure>

<figure><img src="/files/xenZWgL3xrFBmsivgCw4" alt="" width="375"><figcaption></figcaption></figure>
