Skip to main content

1. Issue an Access Token

Bitbucket Cloud

To get the repository access token, navigate to your Bitbucket repository settings and create a new token. When configuring your token, enable the following permissions:
  • Pull requests -> Write, so that Datafold can read your repository and comment on pull requests.
  • Webhooks -> Read and write, so that Datafold can install the webhook it needs (pull request and push events) automatically.

Bitbucket Access Token

Bitbucket Data Center / Server

To get a repository access token, navigate to your Bitbucket repository settings and create a new token. When configuring your token, enable Repository admin permissions. Datafold needs admin access to the repository to read it, comment on pull requests, and configure the webhook automatically.

Bitbucket Server Access Token

2. Configure integration in Datafold

Navigate back to Datafold and fill in the configuration form. Set Deployment to Cloud for Bitbucket Cloud or Self-hosted for Bitbucket Data Center / Server.

Bitbucket Cloud

  • Personal/Project Access Token: the token you created in step 1.
  • Repository: your Bitbucket repository name. For example, if your Bitbucket project URL is https://bitbucket.org/datafold/dbt/, your Repository is datafold/dbt.

Bitbucket Data Center / Server

  • Personal/Project Access Token: the token you created in step 1.
  • Repository: the full URL of your Bitbucket repository. For example, https://bitbucket.myorg.com/projects/datafold/repos/dbt.
Click Save.