---
title: "Buildkite"
canonical_url: "https://docs.getdx.com/connectors/buildkite/"
md_url: "https://docs.getdx.com/connectors/buildkite.md"
last_updated: "2026-05-08"
---

# Buildkite
By integrating Buildkite with DX, you can analyze CI/CD workflow metrics. Please refer to the API documentation below and our [schema explorer](https://docs.getdx.com/schema/) to see what data DX imports.

## Prerequisites

To connect Buildkite to DX, you need:

- a Buildkite [API Access Token](https://buildkite.com/user/api-access-tokens)
- if your Buildkite account has IP restrictions, you need to allowlist [DX IP addresses](https://docs.getdx.com/allowlisting-dx/)

## Setup instructions

Follow the steps below to connect Buildkite to DX.

#### Step 1

1. Log in to Buildkite as an admin and create a new access token.
2. The permissions needed are:
   - read_organizations
   - read_pipelines
   - read_builds

#### 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.

## API reference

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


| Endpoint | Documentation |
|----------------------------------------------------|---------------|
| /organizations/{orgName}/pipelines | [Link](https://buildkite.com/docs/apis/rest-api/pipelines) |
| /organizations/{orgName}/builds | [Link](https://buildkite.com/docs/apis/rest-api/builds) |
| /organizations | [Link](https://buildkite.com/docs/apis/rest-api/organizations) |


## Errors

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


| 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` | DX cannot access any projects or repositories. |
---

## Sitemap

[Overview of all docs pages](/llms.txt)