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
Job titles

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

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.

1. Sign in to the Humaans web app as a workspace admin.

2. Navigate to Settings > API tokens.

3. Click Create token and select the scopes public:read and private:read.

4. Copy the token value. Humaans shows it only once — store it securely.

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

Cloud-hosted

Follow these instructions to use a built-in, no-code connector hosted by C1.

1. In C1, navigate to Integrations > Connectors and click Add connector.

2. Search for Humaans and click Add.

3. Choose how to set up the new Humaans connector.

4. Set the owner for this connector.

5. Click Next.

6. Find the Settings area of the page and click Edit.

7. 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.
8. Click Save.

9. The connector’s label changes to Syncing, followed by Connected. You can view the logs to ensure that information is syncing.

Done. Your Humaans connector is now pulling HR data into C1.

Self-hosted

Follow these instructions to run the Humaans connector in your own environment.

1. Create secrets for the Humaans API token.

2. Configure the connector environment variables:

   BATON_BASE_URL=https://app.humaans.io
   BATON_API_TOKEN=<Humaans personal access token>
   
3. Deploy the connector using your standard self-hosted connector process.

Done. Your Humaans connector is now pulling HR data into C1.

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.