> ## Documentation Index
> Fetch the complete documentation index at: https://ampersand-24eb5c1a-feat-always-enabled-object.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Bitbucket

## What's Supported

### Supported Actions

This connector supports:

* [Proxy Actions](/proxy-actions), using the base URL `https://api.bitbucket.org`.

## Before You Get Started

To connect Bitbucket with Ampersand, you will need [a Bitbucket/Atlassian Account](https://bitbucket.org/).

Once your account is created, you'll need to create an OAuth consumer in your bitbucket workspace, configure the app, and obtain the following credentials from your app:

* Client ID
* Client Secret

You will then use these credentials to connect your application to Ampersand.

### Create a Bitbucket Account

Follow these steps to sign up for a Bitbucket account:

* Go to the [Atlassian website](https://id.atlassian.com/login?application=bitbucket) and sign up for a new account.

### Register a Bitbucket OAuth App

Follow the steps below to register a Bitbucket OAuth app:

1. Log in to your [Bitbucket account](https://id.atlassian.com/login?application=bitbucket).
2. Go to **Workspace Settings** by clicking the gear icon in the top-right navigation bar.
3. Select **OAuth consumers** from the left sidebar then click **Add consumer**.
4. Enter the following details in the create application form:
   1. **Name**: Enter a name for your app.
   2. **Description**: Provide a brief description of your app.
   3. **Callback URL**: Enter the Ampersand redirect URL: `https://api.withampersand.com/callbacks/v1/oauth`.
5. Select the permissions you want to grant to your app.
6. Click **Save**.
   <img src="https://mintcdn.com/ampersand-24eb5c1a-feat-always-enabled-object/JZXebS4adP6Kz-cC/images/provider-guides/bitbucket_oauth.png?fit=max&auto=format&n=JZXebS4adP6Kz-cC&q=85&s=1e13d7d56e76f5b0d4058c73a9401996" alt="Bitbucket Oauth creation" width="1178" height="1866" data-path="images/provider-guides/bitbucket_oauth.png" />

Once your app is created, you can access the **Client ID** and **Client Secret** credentials. Note these down, as you will need them to connect your app to Ampersand.

<img src="https://mintcdn.com/ampersand-24eb5c1a-feat-always-enabled-object/JZXebS4adP6Kz-cC/images/provider-guides/bitbucket_oauth2.png?fit=max&auto=format&n=JZXebS4adP6Kz-cC&q=85&s=210df3774005eb62ad840f19c27012db" alt="Bitbucket Oauth secrets" width="1978" height="856" data-path="images/provider-guides/bitbucket_oauth2.png" />

## Add Your Bitbucket App Info to Ampersand

1. Log in to your [Ampersand Dashboard](https://dashboard.withampersand.com).
2. Select the project where you want to create a Bitbucket integration.\\
   <img src="https://mintcdn.com/ampersand-24eb5c1a-feat-always-enabled-object/MOeKs0aLZCYy4KB-/images/provider-guides/31a6a12-Ampersand.png?fit=max&auto=format&n=MOeKs0aLZCYy4KB-&q=85&s=a0b3b8409e2ad1c01a4a2db29c2b2ca4" alt="Ampersand Project Selection" width="2244" height="442" data-path="images/provider-guides/31a6a12-Ampersand.png" />
3. Select **Provider Apps**.
4. Select **Bitbucket** from the **Provider** list.
5. Enter the previously obtained **Client ID** in the **Client ID** field and the **Client Secret** in the **Client Secret** field.

   <br />

   <img src="https://mintcdn.com/ampersand-24eb5c1a-feat-always-enabled-object/JZXebS4adP6Kz-cC/images/provider-guides/bitbucket_provider_app.gif?fit=max&auto=format&n=JZXebS4adP6Kz-cC&q=85&s=66edf889d50b96daaf498a900f541852" alt="Ampersand Project Selection" width="1920" height="1080" data-path="images/provider-guides/bitbucket_provider_app.gif" />
6. Click **Save Changes**.
