# Buildkite

<div align="left"><img src="https://727226624-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MjFmyReUsbJqDjHEAlW%2Fuploads%2FZql7mMSwnzeoV6MqiafA%2Fbuildkite.png?alt=media&#x26;token=b78ca60a-802b-462d-b91f-53bc3e9128de" alt=""></div>

## Set up

### Navigate to the Integration settings view

1. Select an app in the top left corner from the Switcher
2. Navigate to **App Settings** by clicking the gear icon (⚙️) at the top of the Timeline sidebar
3. Click on **Integrations** in the sidebar

### **Connect Buildkite**

* Find the **Buildkite** integration module under the **CI/CD** section
* Click the **Connect** button
* Enter a Buildkite API Access Token
  * You can generate API Access Tokens within Buildkite: &#x20;
    * :link: [**Buildkite Docs - Managing API Access Tokens**](https://buildkite.com/docs/apis/managing-api-tokens)

{% hint style="info" %}
Runway requires an API Access Token including the following scopes:

* `read_builds`

* `write_builds`

* `read_organizations`

* `read_pipelines`

* `read_artifacts`
  {% endhint %}

* Click **Save**; you’ll be presented with a dialog in which to select your Buildkite org and your Release Candidate pipeline, and (optionally) the name of your release pipeline if different than your RC pipeline

{% hint style="info" %}
Learn more about [builds and branches in Runway](https://docs.runway.team/getting-started/setting-up-your-integrations/builds-and-branches).
{% endhint %}