BitBucket Integration

Enable PR Metrics

Connecting your Bitbucket instance to TargetBoard enables access to all your PR metrics including Cycle Time, Time in Status, tracking of New, Open and Closed Pull Requests and many others.

This document outlines the how to generate an API token with the required scope for TargetBoard to present your data. The token allows secure access to BitBuckets APIs and Git commands.

Before You Begin

1. Log in to BitBucket and click on the Settings icon in the upper-right corner.
2. Navigate to Personal settings > Atlassian account settings > Security.
3. Select Create and manage API tokens > Create API token with scopes and fill in as follows:
   1. Token name: TargetBoard.
   2. Expiry date: Recommended (this will be based on your org policy).
   3. App: BitBucket
   4. Scopes: refer to BitBucket;s API token permissions page to select the minimum necessary access.
   5. Review and click Create Token.
4. Copy and store the token securely (you won't be able to access it again later).
5. Send the following back to TargetBoard:
   1. API token
   2. Repository of workspace access required (optional).