Connect Bitbucket

Connect Bitbucket Cloud or your own Bitbucket Data Center with a token that can only read, and its webhook.

In short

Connect Bitbucket once for the whole organization. Boards then link branches and pull requests to cards, and designs follow the code, through it. {{brand}} only ever reads.

Before you start

Where it lives

  1. Open your organization, then Settings › "Connections", and press "Connect a code host".
  2. Choose "Bitbucket". Under "Which Bitbucket?" choose Bitbucket Cloud, or Bitbucket Data Center and type its address.
  3. Press "Next" - for a Data Center, "Check this step" first.

Sign in

  1. Press "Open the token page" and make an access token with Repositories (Read) and Pull requests (Read). Nothing that writes.
  2. Paste it into "Access token". For an Atlassian API token, write your email, a colon and the token: [email protected]:token.
  3. Type one repository into "A repository to check with", such as acme/payments-api (on Data Center PROJECT/repository).
  4. Press "Check this step": it signs in, reads the repository and its default branch, and refuses a token that can write.

Webhook

  1. Press "Make the address and secret". Copy each - the secret is shown only now.
  2. In Bitbucket open the repository's settings, Webhooks, Add webhook. Paste the address as the URL and the secret as the Secret.
  3. Tick Repository push and the Pull request events created, updated, merged and declined, then Save.
  4. Push a commit to send a first delivery, then press "Look for a delivery".

Check and use

  1. Press "Run the full check". Every step should say Passed; a step that failed names what to change.
  2. Under "Where will you use it?" tick Boards, Designer and API Tester as you need them.
  3. Optional: under "Only these teams" tick the teams that may pick it. Leave it empty for everyone who may use those modules.
  4. Check the "Name" and press "Finish". The connection shows under "Connections" with its health.

If a step fails