---
title: "Connect Humaans"
description: "Connect Humaans"
canonical_url: "https://support.pave.com/articles/connect-humaans-IFeX9vxWvl"
md_url: "https://support.pave.com/articles/connect-humaans-IFeX9vxWvl.md"
---
# Connect Humaans

Humaans is an HRIS integration that syncs employee, job, and compensation data to Pave using an API key.

## Before you connect

* You must be an **administrator** in Humaans to generate an API access token.
* The token you create must include specific permission scopes (listed in the steps below).

## Connect Humaans to Pave


1. In Humaans, navigate to the expanded menu next to your name and select **API access tokens**.
2. Generate a new token with the following scopes:
   * **View public and private data**
   * **View compensations**
3. Copy the generated API key.
4. In Pave, go to **Connections** and find Humaans.
5. Paste the API key into the field provided.
6. Click **Submit**.
7. Go to **Connections** and verify the Humaans integration shows as **In sync**.

## Troubleshooting

**Connection shows an error after submitting** Make sure the API key is entered correctly and has not expired. If the token is missing the required scopes ("View public and private data" and "View compensations"), the connection may fail or return incomplete data. Generate a new token with both scopes and try again.

**Data is missing or incomplete** Pave syncs employee data, job roles, and compensation records from Humaans. If specific employees are missing, confirm they are active in Humaans. If compensation data is missing, check that salary records exist for those employees and that the API token includes the "View compensations" scope.

## Fields that sync

Custom mappings may apply to your account.

* First name, last name
* Work email
* Date of birth
* Job title, department
* Employment type
* Manager name, manager email
* Start date
* Location (city, state, country, zip code, address)
* Base pay, currency
* Bonus
* Commission

### Additional data

* **Compensation history**: Supported. Pave syncs current and historical compensation records with effective dates.
* **Custom fields**: Not supported.
* **Benefits**: Not supported via this integration. You can manually upload benefits data to Pave.