Introduction

To enable the Bitbucket connector, you need a Workspace Access Token. If you are on a non-Premium Bitbucket plan and cannot create a Workspace Access Token, use an App Password instead.

See the schema reference for Bitbucket >

Steps to connect

Step 1

Before setting up a connection for Bitbucket, first complete the steps for setting up a Jira connection – this is required for fully identifying Bitbucket users.

Step 2

If using a Workspace Access Tokens, create a token for DX that includes the scopes account, pipeline, pullrequest, and repository.

If using an App Password, create an App Password for DX with all scopes set to "read."

Step 3

Navigate to the Data Cloud > Connections screen within DX, then add a connection using your credentials generated in the previous steps. Your workspace name is the first path in the URL (i.e., it would be myworkspace given the URL below).

https://bitbucket.org/myworkspace/myrepo/src/main/

Errors

This table lists error codes that you may encounter when adding a connection in DX.

Error	Description
`invalid_credentials`	Your API credentials entered are not valid.
`invalid_permissions`	Your API token does not have the permissions required by DX.
`no_resources`	Your service account does not have access to any projects or repositories.

Troubleshooting

I'm seeing a `Token is invalid or not supported` error

This typically indicates that you are using a Personal API token instead of a Workspace Access Token.