# CircleCI

<div align="left"><img src="https://727226624-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MjFmyReUsbJqDjHEAlW%2F-MjHFgz_NX4gfstfiarj%2F-MjHGKmPje4p3_3L8Il5%2Fcircleci.png?alt=media&#x26;token=aa9d2e2d-56e1-4b5a-8025-bb7f0e851891" 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 CircleCI**

* Find the **CircleCI** integration module under the **CI/CD** section
* Click the **Connect** button
* Enter a CircleCI API Token &#x20;
  * You can generate API Tokens within CircleCI by going to **User Settings > Personal API Tokens > Create New Token**

{% hint style="warning" %}
A **Personal** API token is required to integrate with Runway. A **Project** API token will not work, given CircleCI limits Project tokens to their v1 API (as opposed to v2), and the v1 API lacks many endpoints required for the integration.
{% endhint %}

* Click **Save**; you’ll be presented with a dialog in which to enter the following: &#x20;
  1. Project type (GitHub), org name, and repo name
  2. The name of your RC workflow
  3. (Optional) The name of your release workflow, if different than your RC workflow

{% 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 %}
