Bitbucket Data Center

By integrating Bitbucket Data Center with DX, you can analyze pull requests, repositories, and pipelines data. Please refer to the API documentation below and our schema explorer to see what data DX imports—note that DX does not read or access your source code.

Prerequisites

To connect Bitbucket Data Center to DX, you need:

• a Bitbucket service account
• if your Bitbucket instance is behind a firewall or has IP restrictions, you need to allowlist DX IP addresses

Setup instructions

Follow the steps below to connect Bitbucket Data Center to DX.

Data connection

Step 1

Create a user account in Bitbucket Data Center to use as a service account, and grant the user access to the projects that you would like imported into DX.

Step 2

• Navigate to the connections page in DX and select “+ Connection” in the top right.
• Enter the credentials you have generated in the previous steps—refer to the information below for errors and troubleshooting.

Webhooks

DX supports Bitbucket webhooks ingestion to sync pull request data in real-time. This is recommended in order to ensure real-time data accuracy in DX.

To enable webhook ingestion, follow the steps below:

1. Go to Repository settings > Webhooks > Create Webhook
2. For URL, enter https://yourinstance.getdx.net/webhooks/bitbucket_data_center with your unique subdomain
3. Enter your webhooks secret from DX—this can be found and copied in the Connections admin page.
4. Enable the following Pull Request events:
   • Opened
   • Modified
   • Approved
   • Declined
   • Unapproved
   • Merged
5. (Optional) Test the connection by clicking on Test connection.
6. Click save.

Here’s an example of what your settings should look like:

API reference

The table below lists the specific API endpoints that are used by DX.

Errors

The table below lists potential error codes when adding a connection in DX.