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

# Set up a CharlieHR connector

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

C1 provides identity governance for CharlieHR. Integrate your CharlieHR company
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 your CharlieHR company's team members as user identities.
Each user carries their name, email, job title, and active/inactive status, so
you can see who belongs to your company in CharlieHR.

## Gather CharlieHR credentials

<Warning>
  You need a CharlieHR **API key**. Only a Super Admin can create one, and it
  grants read access to your company's people data, so treat it as a secret.
</Warning>

<Steps>
  <Step>
    Sign in to CharlieHR as a Super Admin of the company you want to sync.
  </Step>

  <Step>
    Open your company **Settings** and find the **Integrations / API** area.
  </Step>

  <Step>
    Create a new API key, give it a descriptive name, and copy the generated
    key — you may not be able to see it again.
  </Step>
</Steps>

## Configure the CharlieHR 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 **Apps** > **Connectors** and click **Add connector**.
      </Step>

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

      <Step>
        Choose where to add the connector: **Create a new app**, or **Add to an existing app** (then select the app).

        If you're creating a new app, choose whether to link it to an application discovered from your identity provider: select **Yes** and pick the IdP application, or **No** to continue with just the connector.
      </Step>

      <Step>
        Set the connector's **Name** and, optionally, a **Description**.
      </Step>

      <Step>
        Click the pencil icon next to **Owners** to choose who can configure and manage this connector.
      </Step>

      <Step>
        Click **Add**. The connector is created and its configuration page opens.
      </Step>

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

      <Step>
        Enter the CharlieHR credentials:

        * **API key**: The CharlieHR API key you created.
      </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 CharlieHR connector is now pulling access data into C1.
  </Tab>

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

    <Steps>
      <Step>
        Create a secret for the CharlieHR API key.
      </Step>

      <Step>
        Configure the connector environment variables:

        * **BATON\_CHARLIEHR\_API\_KEY**: The CharlieHR API key (store this as a secret).
      </Step>

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

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