> ## Documentation Index
> Fetch the complete documentation index at: https://conductorone-docs-mcp-bridge-private-server.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Set up a CircleCI connector

> C1 provides identity governance for CircleCI. Integrate your CircleCI organization with C1 for unified visibility and governance over user access.

C1 provides identity governance for CircleCI. Integrate your CircleCI
organization with C1 for unified visibility and governance over user access.

## Capabilities

| Resource | Sync                                                          | Provision |
| -------- | ------------------------------------------------------------- | --------- |
| Users    | <Icon icon="square-check" iconType="solid" color="#c937ae" /> |           |

The connector syncs the members of a single CircleCI organization as user
identities. Each user carries their organization role (for example admin or
member) and VCS login, so you can see who has access to your CircleCI
organization and at what level.

## Gather CircleCI credentials

<Warning>
  You need a CircleCI **personal API token**. It is sent on every request in the
  `Circle-Token` header and grants API access as your account, so treat it as a
  secret. The token must belong to a member of the organization who can read its
  member list.
</Warning>

<Steps>
  <Step>
    Sign in to CircleCI as a member of the organization you want to sync.
  </Step>

  <Step>
    Open **User Settings**, then go to **Personal API Tokens**.
  </Step>

  <Step>
    Click **Create New Token**, give it a descriptive name, and copy the
    generated token — you will not be able to see it again.
  </Step>

  <Step>
    Find your organization ID. Call `GET https://circleci.com/api/v2/me/collaborations`
    with your token and copy the `id` (a UUID) of the organization you want to
    sync. This is the organization ID, not the organization name or VCS slug.
  </Step>
</Steps>

## Configure the CircleCI connector

<Tabs>
  <Tab title="Cloud-hosted">
    Follow these instructions to use a built-in, no-code connector hosted by C1.

    <Steps>
      <Step>
        In C1, navigate to **Integrations** > **Connectors** and click **Add connector**.
      </Step>

      <Step>
        Search for **CircleCI** and click **Add**.
      </Step>

      <Step>
        Choose how to set up the new CircleCI connector.
      </Step>

      <Step>
        Set the owner for this connector.
      </Step>

      <Step>
        Click **Next**.
      </Step>

      <Step>
        Find the **Settings** area of the page and click **Edit**.
      </Step>

      <Step>
        Enter the CircleCI credentials:

        * **API token**: The personal API token you created.
        * **Organization ID**: The organization UUID you copied.
      </Step>

      <Step>
        Click **Save**.
      </Step>

      <Step>
        The connector's label changes to **Syncing**, followed by **Connected**. You can view the logs to ensure that information is syncing.
      </Step>
    </Steps>

    **Done.** Your CircleCI connector is now pulling access data into C1.
  </Tab>

  <Tab title="Self-hosted">
    Follow these instructions to run the CircleCI connector in your own
    environment.

    <Steps>
      <Step>
        Create a secret for the CircleCI personal API token.
      </Step>

      <Step>
        Configure the connector environment variables:

        * **BATON\_CIRCLECI\_API\_TOKEN**: The CircleCI personal API token (store this as a secret).
        * **BATON\_CIRCLECI\_ORG\_ID**: The CircleCI organization UUID to sync.
      </Step>

      <Step>
        Deploy the connector using your standard self-hosted connector process.
      </Step>
    </Steps>

    **Done.** Your CircleCI connector is now pulling access data into C1.
  </Tab>
</Tabs>