Buildkite - How do I link my account?

OverviewCopy Anchor Link

To authenticate with Buildkite, you need:

1. API Access Token — a token that lets Tenklo call the Buildkite REST API on your behalf.

This guide will show you how to create one.

PrerequisitesCopy Anchor Link

• A Buildkite account that is a member of the organization you want to connect.

Step 1: Create an API access tokenCopy Anchor Link

1. Log in to Buildkite.
2. Click your profile icon in the top-right corner, select Personal Settings, then select API Access Tokens.
3. Click New API Access Token and enter a description.

4. Under Organization Access, select the organization you want to connect.

5. Select the REST API scopes your integration needs, such as read_organizations, read_pipelines, and read_builds.

6. Under GraphQL API Access, choose whether the token can call the Buildkite GraphQL API:

   • Disabled — the token can't call the GraphQL API.
   • Read-only — allows GraphQL queries but rejects mutations.
   • Full access — allows GraphQL queries and mutations.

   GraphQL access isn't limited by the REST API scopes above. It uses your user account's permissions in the selected organizations.

7. Optionally, restrict where the token can be used from by entering IP ranges in CIDR notation under Allowed IP Addresses. If you do, add Tenklo's public IP addresses so Tenklo can reach the Buildkite API.

8. Under Token Expiry, select Never so the token doesn't expire. Tokens expire after seven days by default, and an expired token breaks the connection.

9. Click Create New API Access Token and copy the token. It starts with bkua_.

Step 2: Enter your token in the Connect UICopy Anchor Link

1. Open the form where you need to authenticate with Buildkite.
2. Enter your API Access Token in the designated field.
3. Submit the form, and you should be successfully authenticated.

You are now connected to Buildkite.