Overview
To authenticate Humaans.io, you will need to generate an API Key and paste it into the linking flow.
Prerequisites
Please ensure you have Admin permissions in your company's Humaans.io instance or someone has shared their access with you.
Instructions
Step 1: Generate your API key
Log into the platform
From the sidebar, click the three dots to extend the drop-down menu. Then click "API access tokens."
3. Create or edit an existing API Key
If you have an existing API key, you can use the edit button to update the scopes on the key
If you do not have an existing key, use the "Generate new token" button to create a new key:
4. Configure the scopes you will need for your integration
"View public and private data" is required for to pull pre-hires to detect off-boarded employees. Without this scope, employees will not be picked up until their date of hire and employees will not be identified as terminated.
Enabling "View public and private data" allows us to read information including:
gender
date of birth
country
city
state
zip_code
remote_id
job_title
phone_number
email_address
data for new hires and offboarded employees
If you need compensation data for your integration, enable "View compensations"
You can reference the Humaans docs for more details on API key scopes
Head to the Integrations page in Happl
From your home screen head to Settings then Integrations and hit 'Connect' under the HRIS section.
Follow Flow for Adding Your API Key to Happl
Once you have selected Humaans from the HRIS integration list, follow the steps to complete the connection.
Sync Data to Happl
Once you have completed the above steps the data sync will begin to Happl. Depending on the size of your business this could take a few minutes to an hour. Once complete you will be able to review the data in the 'Data Audit' Section of Settings.