# Buildkite

Buildkite is a CI/CD platform that lets engineering teams run fast, scalable pipelines on their own infrastructure. It gives you full visibility into build executions, pipeline health, agent clusters, and test analytics — all in one place.

Connecting Buildkite to Coupler.io lets you pull that data into your reporting tools so you can track build performance, monitor pipeline reliability, and share insights with your team without manual exports.

## Why connect Buildkite to Coupler.io?

* **Centralize CI/CD metrics** — combine build data with project management or incident data in one dashboard
* **Track pipeline health over time** — analyze build success rates, durations, and failure trends across pipelines
* **Share data without API access** — export Buildkite data to Google Sheets, Excel, or BI tools for non-technical stakeholders
* **AI-powered analysis** — send build data to ChatGPT, Claude, or Gemini to surface patterns and anomalies

## Prerequisites

* A Buildkite account with at least one organization
* A Buildkite API access token with read permissions for the entities you want to export (generate one in **Personal Settings → API Access Tokens**)

## Quick start

{% hint style="success" %}
Start with the **Builds** or **Organizations pipelines builds** entity — these give you the richest data for pipeline health reporting right away.
{% endhint %}

## How to connect

{% stepper %}
{% step %}
**Create a new data flow in Coupler.io.** Go to your Coupler.io dashboard and click **Add data flow**. Search for and select **Buildkite** as your source.
{% endstep %}

{% step %}
**Enter your Buildkite API token.** In the source settings, paste your Buildkite API access token. You can generate one in Buildkite under **Personal Settings → API Access Tokens**. Make sure the token has the appropriate read scopes for the entities you plan to export.
{% endstep %}

{% step %}
**Select an entity.** Choose which Buildkite entity you want to pull — for example, **Builds**, **Organizations pipelines**, or **Analytics organizations suites**. If you want data from multiple entities, you can add more sources to the same data flow.
{% endstep %}

{% step %}
**Set a start date.** Use the date picker to specify the earliest date for data extraction. Buildkite will return data from that date onward.
{% endstep %}

{% step %}
**Choose a destination.** Select where you want your data to land — Google Sheets, Excel, BigQuery, Looker Studio, or an AI destination like ChatGPT, Claude, or Gemini.
{% endstep %}

{% step %}
**Run the data flow.** Click **Run** to execute your first manual sync. Once it completes successfully, your Buildkite data will appear in your chosen destination.
{% endstep %}
{% endstepper %}

## Available entities

| Entity                         | Description                                        |
| ------------------------------ | -------------------------------------------------- |
| Organizations                  | Organizations linked to your Buildkite account     |
| Analytics organizations suites | Test suite analytics data within organizations     |
| Organizations pipelines        | CI/CD pipelines configured in your organizations   |
| Organizations builds           | Build executions scoped to an organization         |
| Organizations pipelines builds | Builds for specific pipelines within organizations |
| Builds                         | All build executions and statuses across pipelines |
| Organizations clusters         | Agent clusters configured within organizations     |
| Organizations clusters queues  | Job queues associated with agent clusters          |
| Organizations clusters tokens  | Auth tokens for agent clusters                     |
| Organizations emojis           | Custom emoji configurations                        |
| Access tokens                  | API access tokens for your account                 |
| Users                          | User account and profile details                   |