BuildKite

Connect your Buildkite organization to BuildButler to import pipeline runs, test results, and agent data.

Generate a Buildkite API Token

1. Go to Buildkite → Personal Settings → API Access Tokens.
2. Click New API Access Token.
3. Give it a name like buildbutler.
4. Select your organization.
5. Grant the following scopes:
   • Read Builds — access build results and logs
   • Read Pipelines — list pipelines and their configuration
   • Read Agents — monitor agent status
6. Click Create Token and copy it.

Add the connection in BuildButler

Navigate to Settings → Integrations → Add Buildkite Connection and fill in the form:

{
  "name": "My Buildkite Org",
  "organization": "my-org",
  "token": "bkua_..."
}

Click Test Connection to verify.

Data mapping

Buildkite concepts map to BuildButler as follows:

Webhook setup (optional)

For real-time updates, configure a Buildkite webhook:

1. Go to Organization Settings → Notification Services → Add Webhook.
2. Set the Webhook URL to your BuildButler webhook endpoint.
3. Select events: build.finished, job.finished.
4. Click Add Webhook Notification.

Permissions required

Troubleshooting