> For the complete documentation index, see [llms.txt](https://helpcenter.xopero.com/xopero-one-en/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://helpcenter.xopero.com/xopero-one-en/backup-and-recovery/devops/bitbucket/integration/adding-bitbucket-organization-to-xopero-one.md).
# Adding Bitbucket organization to Xopero ONE
## Using OAuth
{% stepper %}
{% step %}
Log in to [**XMS**](#user-content-fn-1)[^1], open the **DevOps** tab on the left side of the window, and select **Bitbucket** from the list.
{% endstep %}
{% step %}
Click the **Connect** button under **Bitbucket**.
{% endstep %}
{% step %}
A pop-up with **Bitbucket** login page will appear. Log in using your admin credentials and grant **Xopero ONE** access to the specified resources (when prompted).
{% endstep %}
{% step %}
Your **Bitbucket** organization has now been successfully added to **Xopero** **ONE**. Click **Custom policy** to adjust your backup policy settings, or click **Run backup** to execute the backup immediately using the current policy configuration.
{% endstep %}
{% endstepper %}
***
## Using OAuth (Advanced Mode)
{% stepper %}
{% step %}
Log in to [**XMS**](#user-content-fn-1)[^1], open the **DevOps** tab on the left side of the window, and select **Bitbucket** from the list.
{% endstep %}
{% step %}
Click the **advanced mode** link under **Bitbucket** and **Bitbucket DC** tiles.
{% endstep %}
{% step %}
Set your authentication method.
1. In **Authentication**, select **Bitbucket**.
2. For **Connect using**, choose **OAuth App**.
3. In the **Settings** section, choose whether to enable **read-only mode** and whether **Xopero** should automatically add new repositories to your backup.
{% hint style="warning" %}
If the **Read-Only Access** switch is enabled, the recovery options will be disabled.
{% endhint %}
{% endstep %}
{% step %}
Configure your repository sync and default worker. Specify hours for synchronization, or set a time interval for automatic updates.
{% endstep %}
{% step %}
Click **Proceed** to complete adding your **Bitbucket** organization and grant **Xopero ONE** access to the specified resources (when prompted).
{% endstep %}
{% endstepper %}
***
## Using an API token
{% stepper %}
{% step %}
Log in to [**XMS**](#user-content-fn-1)[^1], open the **DevOps** tab on the left side of the window, and select **Bitbucket** from the list.
{% endstep %}
{% step %}
Click the **advanced mode** link under **Bitbucket** and **Bitbucket DC** tiles.
{% endstep %}
{% step %}
Set your authentication method.
1. In **Authentication**, select **Bitbucket**.
2. For **Connect using**, choose **Username and App password**.
3. Enter your **Bitbucket** email address.
4. Add or select **App Password** that contains your API token from the **Password Manager**.
5. Choose whether **Xopero** should automatically add new repositories to your backup.
{% endstep %}
{% step %}
Configure your repository sync and default worker. Specify hours for synchronization, or set a time interval for automatic updates.
{% endstep %}
{% step %}
Click **Proceed** to complete adding your **Bitbucket** organization and grant **Xopero ONE** access to the specified resources.
{% endstep %}
{% endstepper %}
***
## Additional browser permissions
When adding an organization, you may be prompted to grant additional permissions to the **Xopero ONE** application— make sure your browser allows **Xopero** to open pop-up windows.
Depending on your browser, you can either adjust the settings to allow pop-ups or permit the authorization window to open once.
***
## Useful links and items
{% embed url="" %}
[^1]: Xopero ONE Management Service
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## 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, and the optional `goal` query parameter:
```
GET https://helpcenter.xopero.com/xopero-one-en/backup-and-recovery/devops/bitbucket/integration/adding-bitbucket-organization-to-xopero-one.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
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.