Generating your API Key
1.) To generate an API key for a Humaans.io integration, start by logging into the platform.
2.) From the sidebar, click the three dots to extend the drop-down menu. 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. Skip to Step 5
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.
At a minimum Merge will need "View public data" to retrieve basic employee data like name, email, and job title.
Enabling "View public and private data" allows us to read information including:
date of birth
If you need compensation data for your integration (Merge employment object), enable "View compensations".
You can reference the Humaans docs for more details on API key scopes.