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.