> ## 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.

# CircleCI

> Connecting CircleCI to Unblocked

To connect CircleCI 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 CircleCI">
    Click on the **CircleCI** 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 CircleCI Account">
    * Create a new [Personal API Token](https://app.circleci.com/settings/user/tokens) in CircleCI:

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

    * Click **Add API Token**.

    * Paste the token into Unblocked.

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

  <Step title="Select Projects">
    Select the CircleCI projects you want to enable. Unblocked lists recently used projects and projects that
    you follow in CircleCI.

    If a project is not listed, you can add it by entering the project slug, which you can find in the
    project settings in CircleCI.

    Unblocked will automatically install an outgoing webhook in CircleCI for each project you select, so
    that it can receive notifications when builds fail.
  </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 CircleCI failures in the selected repositories and post reports to pull
    requests.

    <img src="https://mintcdn.com/unblocked/XfgrfEzBJgxcMSOE/img/ci/ci-circleci-complete.png?fit=max&auto=format&n=XfgrfEzBJgxcMSOE&q=85&s=2fd88db2f001e035659f7b7388943525" alt="CircleCI token" width="2880" height="1800" data-path="img/ci/ci-circleci-complete.png" />
  </Step>
</Steps>