By integrating Bitbucket with DX, you can analyze pull requests, repositories, and workflow data. Please visit our <a href="https://app.getdx.com/datacloud/schema" rel="nofollow noopener noreferrer" target="_blank">schema explorer</a> to see what data DX imports—note that DX does not read or access your source code.

if your Bitbucket instance is behind a firewall or has IP restrictions, you need to allowlist <a href="https://help.getdx.com/en/articles/8487041-connections-to-on-prem-tools">DX IP addresses</a>

- a Bitbucket service account
- if your Bitbucket instance is behind a firewall or has IP restrictions, you need to allowlist <a href="https://help.getdx.com/en/articles/8487041-connections-to-on-prem-tools">DX IP addresses</a>

Create a user account in Bitbucket Data Center to use as a service account.

Grant the user access to the projects that you would like imported into DX.

1. Create a user account in Bitbucket Data Center to use as a service account.
2. Grant the user access to the projects that you would like imported into DX.

Navigate to the connector setup form in DX.

Enter the credentials you have generated in the previous steps—refer to the information below for errors and troubleshooting.

1. Navigate to the connector setup form in DX.
2. Enter the credentials you have generated in the previous steps—refer to the information below for errors and troubleshooting.

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

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

DX supports Bitbucket Data Center webhooks ingestion to sync pull request data in real-time. This may be beneficial for large organizations that have difficulty keeping data up-to-date in DX through batch imports.

To enable webhook ingestion, follow the steps below:

Go to Repository settings -&gt; Webhooks -&gt; Create Webhook

For URL, enter your instance URL (<code>yourinstance.getdx.net</code>) followed by <code>/webhooks/bitbucket_data_center</code>

Enter the secret provided to you by your DX account manager.

1. <code>Opened</code>
2. <code>Modified</code>
3. <code>Approved</code>
4. <code>Declined</code>
5. <code>Unapproved</code>
6. <code>Merged</code>

(Optional) Test the connection by clicking on <code>Test connection</code>.

1. Go to Repository settings -&gt; Webhooks -&gt; Create Webhook
2. For URL, enter your instance URL (<code>yourinstance.getdx.net</code>) followed by <code>/webhooks/bitbucket_data_center</code>
3. Enter the secret provided to you by your DX account manager.
4. Choose following events:
   1. <code>Opened</code>
   2. <code>Modified</code>
   3. <code>Approved</code>
   4. <code>Declined</code>
   5. <code>Unapproved</code>
   6. <code>Merged</code>
5. (Optional) Test the connection by clicking on <code>Test connection</code>.
6. Click on <code>Save</code>.

Bitbucket Data Center

Find answers and get help from Intercom Support and Community Experts

Link, Press control-option-right-arrow to exit

Empty Help Center

Uh oh. That page doesn’t exist.

Disappointed

Neutral

Smiley

Thinking...

Searching through sources...

Analyzing...

Tickets submitted through the messenger or by a support agent in your conversation will appear here.

Endpoint	Documentation
/projects	List projects
/projects/{project_key}/repos	List project repositories
/projects/{project_key}/repos/{repository_slug}/pull-requests	List pull requests
/projects/{project_key}/repos/{repository_slug}/pull-requests/{pull_request_source_id}/diff	List pull request diff
/projects/{project_key}/repos/{repository_slug}/pull-requests/{pull_request_id}/activities	List pull request activity logs
/admin/users	List users

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.

Bitbucket Data Center

Prerequisites

Setup instructions

Step 1

Step 2

API Reference

Errors

Webhooks