> For the complete documentation index, see [llms.txt](https://sandgarden.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://sandgarden.gitbook.io/docs/getting-started/connect-bitbucket.md).

# Connect Bitbucket

Use this guide to connect Bitbucket Sources in Doc Holiday. Bitbucket Sources react only to pull requests and pull request comments; issue and release triggers do not apply. See [Configure triggers](/docs/publications/configure-triggers.md).

If the Source already exists, update it in [Manage connections](/docs/sources/manage-connections.md).

### Option A: workspace token provider and Bitbucket Project

Use this path when one workspace token should cover multiple projects.

1. Open **Sources**, then select the **Providers** tab.
2. Select **Add Provider**.
3. Choose **Bitbucket Workspace Access Token**.
4. Enter **Token Name**, **Workspace**, and **Access Token**.
5. Select **Save Changes**.
6. Open the **Sources** tab and select **Add Source**.
7. Choose **Bitbucket Project**.
8. Enter **Source Name**, **Repository**, **Branch**, and **Publishing System**.
9. Select **Save Changes**.

### Option B: repository access token for one repository

Use this path when one repository needs its own access token.

1. Open **Sources** and select **Add Source**.
2. Choose **Bitbucket Project**.
3. Select **Click here to connect with a repository access token instead**.
4. Enter **Source Name**, **Repository Access Token**, **Repository**, **Branch**, and **Publishing System**.
5. Select **Save Changes**.

### Verify

Open the **Sources** page and confirm the Source shows **Healthy**.

### Next

Continue with [Create your first Publication](/docs/getting-started/create-your-first-publication.md).