> ## 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 Humaans connector

> C1 provides identity governance for Humaans. Integrate your Humaans HRIS with C1 for unified visibility over employees and job titles.

C1 provides identity governance for Humaans. Integrate your Humaans HRIS
with C1 for unified visibility over employees and job titles.

## Capabilities

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

The connector reads Humaans Persons (employees) and job-role history from
your Humaans workspace. Humaans is a single-tenant HRIS — one API token
connects to one company.

This connector is read-only. It does not provision or modify data in Humaans.

## Gather Humaans credentials

<Warning>
  Create a Humaans API token with **`public:read`** and **`private:read`**
  scopes. Both are required. Do not grant compensation, document, or write
  scopes — the connector does not read those surfaces.
</Warning>

<Steps>
  <Step>
    Sign in to the [Humaans web app](https://app.humaans.io) as a workspace
    admin.
  </Step>

  <Step>
    Navigate to **Settings** > **API tokens**.
  </Step>

  <Step>
    Click **Create token** and select the scopes **`public:read`** and
    **`private:read`**.
  </Step>

  <Step>
    Copy the token value. Humaans shows it only once — store it securely.
  </Step>
</Steps>

## Synced resource types

* **Users**: Humaans Persons (employees). Humaans calls these "Persons"; the
  connector exposes them as users for cross-connector identity correlation.
* **Job titles**: Per-person job-role history. These are descriptive HR titles,
  not IAM roles — no permissions are attached.

## Configure the Humaans 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 **Humaans** and click **Add**.
      </Step>

      <Step>
        Choose how to set up the new Humaans 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 Humaans credentials:

        * **Base URL**: `https://app.humaans.io` (do not include a trailing `/api`).
        * **API token**: The personal access token you created in Humaans.
      </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 Humaans connector is now pulling HR data into C1.
  </Tab>

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

    <Steps>
      <Step>
        Create secrets for the Humaans API token.
      </Step>

      <Step>
        Configure the connector environment variables:

        ```bash theme={"theme":{"light":"css-variables","dark":"css-variables"}}
        BATON_BASE_URL=https://app.humaans.io
        BATON_API_TOKEN=<Humaans personal access token>
        ```
      </Step>

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

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

## Connector configuration reference

| Setting   | Environment variable | Required | Description                                                                               |
| --------- | -------------------- | -------- | ----------------------------------------------------------------------------------------- |
| Base URL  | `BATON_BASE_URL`     | Yes      | Humaans API base URL, usually `https://app.humaans.io`. Do not include a trailing `/api`. |
| API token | `BATON_API_TOKEN`    | Yes      | Personal access token with `public:read` and `private:read` scopes. Stored as a secret.   |