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

# Bitbucket

<AccordionGroup>
  <Accordion title="Prerequisites" icon="list-check">
    * An Enkryptify workspace with admin access
    * A Bitbucket account with admin permissions on the target workspace and repository
    * Bitbucket Pipelines enabled on the target repository
  </Accordion>

  <Accordion title="Permissions" icon="scroll-text">
    When connecting Enkryptify to Bitbucket via OAuth, we request only the permissions required to manage pipeline variables on your selected repository:

    * OAuth scopes:
      * `pipeline:variable`: read and write pipeline variables (repository-level and deployment environment-level)
      * `repository`: read-only access to list workspaces and repositories
      * `account`: read account information for workspace listing

    > Enkryptify does not access your repository source code. The OAuth token is used solely for API calls to manage pipeline variables.
  </Accordion>
</AccordionGroup>

## Steps to complete

<Steps>
  <Step title="Create a new sync">
    * Go to the `Syncs` tab of your project and click on `Bitbucket`.
  </Step>

  <Step title="Authorize with Bitbucket">
    * You'll be redirected to Bitbucket to authorize the Enkryptify OAuth consumer.
    * Grant access to the requested permissions.
  </Step>

  <Step title="Select your Bitbucket repository">
    * All repositories across your Bitbucket workspaces will be listed.
    * Select the target repository for syncing pipeline variables.
  </Step>

  <Step title="Choose sync target and map environments">
    * **Bitbucket target**: choose where variables are synced to:
      * **Repository Pipeline Variables**: available to all pipeline runs in the repository.
      * **Deployment environment**: scoped to a specific deployment environment (e.g., `staging`, `production`). Only available if you have deployment environments configured in Bitbucket.
    * **Enkryptify environment**: select which Enkryptify environment to sync secrets from.
    * Example: Enkryptify `production` environment synced to Bitbucket `Production` deployment environment.
  </Step>
</Steps>