> ## Documentation Index
> Fetch the complete documentation index at: https://infisical.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Bitbucket connection

> Learn how to configure a Bitbucket Connection for Infisical.

Infisical supports the use of [API Tokens](https://support.atlassian.com/bitbucket-cloud/docs/api-tokens/) to connect with Bitbucket.

> [!TIP]
>
> Infisical recommends creating a dedicated Bitbucket account with access restricted to only the resources your use case requires.

## Create Bitbucket access token

**1. Create API Token**

Go to [Account API Tokens](https://id.atlassian.com/manage-profile/security/api-tokens) and select **Create API token with scopes**.

![Create API Token](https://mintlify.s3.us-west-1.amazonaws.com/infisical/images/app-connections/bitbucket/step-1.png)

**2. Set Name and Expiry**

Set the name and expiration date of the token, then click **Next**.

![Set Name and Expiry](https://mintlify.s3.us-west-1.amazonaws.com/infisical/images/app-connections/bitbucket/step-2.png)

> [!NOTE]
>
> Keep in mind that you'll need to manually replace the token after it expires.

**3. Select Bitbucket**

Select **Bitbucket** and then click **Next**.

![Select Bitbucket](https://mintlify.s3.us-west-1.amazonaws.com/infisical/images/app-connections/bitbucket/step-3.png)

**4. Configure Permissions**

Configure permissions according to your app's use case:

> [tab] Secret Scanning
>
> ```
> read:workspace:bitbucket
> read:user:bitbucket
> read:project:bitbucket
> read:webhook:bitbucket
> write:webhook:bitbucket
> delete:webhook:bitbucket
> read:repository:bitbucket
> ```
>
> ![Configure Permissions](https://mintlify.s3.us-west-1.amazonaws.com/infisical/images/app-connections/bitbucket/step-4.png)

> [tab] Secret Sync
>
> ```
> read:workspace:bitbucket
> admin:workspace:bitbucket
> read:user:bitbucket
> read:project:bitbucket
> read:repository:bitbucket
> read:pipeline:bitbucket
> write:pipeline:bitbucket
> admin:pipeline:bitbucket
> ```
>
> ![Configure Permissions](https://mintlify.s3.us-west-1.amazonaws.com/infisical/images/app-connections/bitbucket/step-4-secret-sync.png)

Select **Next**.

**5. Copy Token**

Save the API Token for later steps.

![Save Token](https://mintlify.s3.us-west-1.amazonaws.com/infisical/images/app-connections/bitbucket/step-5.png)

## Create Bitbucket connection in Infisical

> [tab] Infisical UI
>
> **1. Navigate to App Connections**
>
> In your Infisical dashboard, navigate to the **Integrations** tab in the desired project, then select **App Connections**.
>
> ![App Connections Tab](https://mintlify.s3.us-west-1.amazonaws.com/infisical/images/app-connections/general/add-connection.png)
>
> **2. Select Bitbucket Connection**
>
> Click the **Add new connection** button and select **Bitbucket** from the list of available connections.
>
> **3. Fill out the Bitbucket Connection Modal**
>
> Complete the Bitbucket Connection form by entering:
>
> * A descriptive name for the connection
> * An optional description for future reference
> * Your Bitbucket email
> * The API Token from earlier steps
>
>   ![Bitbucket Connection Modal](https://mintlify.s3.us-west-1.amazonaws.com/infisical/images/app-connections/bitbucket/step-6.png)
>
> **4. Connection Created**
>
> After clicking Create, your **Bitbucket Connection** is established and ready to use with your Infisical project.
>
> ![Bitbucket Connection Created](https://mintlify.s3.us-west-1.amazonaws.com/infisical/images/app-connections/bitbucket/step-7.png)

> [tab] API
>
> To create a Bitbucket Connection, make an API request to the [Create Bitbucket Connection](https://infisical.com/docs/api-reference/endpoints/app-connections/bitbucket/create.md) API endpoint.
>
> ### Sample request
>
> ```bash Request theme={"dark"}
> curl    --request POST \
>         --url https://app.infisical.com/api/v1/app-connections/bitbucket \
>         --header 'Content-Type: application/json' \
>         --data '{
>             "name": "my-bitbucket-connection",
>             "method": "api-token",
>             "projectId": "7ffbb072-2575-495a-b5b0-127f88caef78",
>             "credentials": {
>                 "email": "user@example.com",
>                 "apiToken": "<YOUR-API-TOKEN>"
>             }
>         }'
> ```
>
> ### Sample response
>
> ```bash Response theme={"dark"}
> {
>   "appConnection": {
>       "id": "e5d18aca-86f7-4026-a95e-efb8aeb0d8e6",
>       "name": "my-bitbucket-connection",
>       "projectId": "7ffbb072-2575-495a-b5b0-127f88caef78",
>       "description": null,
>       "version": 1,
>       "orgId": "6f03caa1-a5de-43ce-b127-95a145d3464c",
>       "createdAt": "2025-04-23T19:46:34.831Z",
>       "updatedAt": "2025-04-23T19:46:34.831Z",
>       "isPlatformManagedCredentials": false,
>       "credentialsHash": "7c2d371dec195f82a6a0d5b41c970a229cfcaf88e894a5b6395e2dbd0280661f",
>       "app": "bitbucket",
>       "method": "api-token",
>       "credentials": {
>           "email": "user@example.com"
>       }
>   }
> }
> ```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.