# 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>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.hivel.ai/integrations/scm/bitbucket/bitbucket-integration.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.