Buildkite APIs


The Buildkite REST and GraphQL APIs expect an access token to be provided using the Authorization HTTP header:

curl -H "Authorization: Bearer $TOKEN"

Generate an access token.

All webhooks contain an X-Buildkite-Token header which allows you to verify the authenticity of the request.


The Buildkite REST API aims to give you complete programmatic access and control of Buildkite to extend, integrate and automate anything to suit your particular needs.

  1. Generate an API access token with as much scope as you need.
  2. Make requests to using the token you generated in the Authorization header:

    curl -H "Authorization: Bearer $TOKEN"

More information about the REST API.


The Buildkite GraphQL API provides an alternative to the REST API. It allows for more efficient retrieval of data by enabling you to fetch multiple, nested resources in a single request.

  1. Generate an API access token with GraphQL scope
  2. Open the GraphQL explorer
  3. Follow the GraphQL tutorial

More information about the GraphQL API.


Webhooks allow you to monitor and respond to events within your Buildkite organization, providing a real time view of activity and allowing you to extend and integrate Buildkite into your systems.

Webhooks can be added and configured on your organization's Notification Services settings page.

More information about the webhooks.