> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getunblocked.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Buildkite

> Connecting Buildkite to Unblocked

To connect Buildkite to Unblocked, follow these steps:

<Steps>
  <Step title="Add a CI Provider">
    In the left sidebar, click on **Settings**, then **Continuous Integration**.
    Then click on **Add a CI platform**.
  </Step>

  <Step title="Connect Buildkite">
    Click on the **Buildkite** tile.

    <img src="https://mintcdn.com/unblocked/yVsbHSyeiIZi1Xp1/img/ci/Data-Sources-CI-Integrations.png?fit=max&auto=format&n=yVsbHSyeiIZi1Xp1&q=85&s=e6a299769b0a789f5a462d89d323603a" alt="CI Add" width="2880" height="1820" data-path="img/ci/Data-Sources-CI-Integrations.png" />
  </Step>

  <Step title="Authorize Your Buildkite Account">
    * Create a new [API Access Token](https://buildkite.com/user/api-access-tokens) in Buildkite:

    * Enter "Unblocked" as the **Description**.

    * Choose the appropriate organization in **Organization Access**.

    * Select the following **REST API Scopes**:
      * `read_build_logs`
      * `read_builds`
      * `read_organizations`
      * `read_pipelines`
      * `read_user`

    * Copy the following CIDR ranges into **Allowed IP Addresses**:
      * `34.212.246.90/32`
      * `44.235.109.70/32`
      * `44.236.252.193/32`
      * `52.88.232.82/32`

    * Click **Create New API Access Token**.

          <img src="https://mintcdn.com/unblocked/XfgrfEzBJgxcMSOE/img/ci/ci-buildkite-token.png?fit=max&auto=format&n=XfgrfEzBJgxcMSOE&q=85&s=81c8d9dbbd1f1ef821acd506b362ee2a" alt="Buildkite token" width="2880" height="1800" data-path="img/ci/ci-buildkite-token.png" />
  </Step>

  <Step title="Add a Buildkite Webhook">
    * Go to the [Notification Services](https://buildkite.com/organizations/-/services) page.

    * Click Add Webhook.

    * In the **description** field, enter "Unblocked".

    * Copy and Paste the **Webhook URL** and **Token** from Unblocked into the corresponding fields in
      Buildkite.

    * Select the following event:
      * `build-finished`

    * Ensure that **All Pipelines** are selected.

    * Leave **Branch filtering** blank.

    * Click **Add Webhook Notification**.
  </Step>

  <Step title="Select Repositories">
    Toggle the repositories you want to enable by selecting them.
  </Step>

  <Step title="Done">
    Click **Save Settings** to apply your changes.
    Now Unblocked will analyze Buildkite failures in the selected repositories and post reports to pull
    requests.
  </Step>
</Steps>
