In order to link your integration, you will need to generate an API Key.


To generate an API key for a integration, start by logging into the platform.


From the sidebar, click the three dots to extend the drop-down menu. Click 'API access tokens'.


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 the last step.

  • If you do not have an existing key, use the ‘Generate new token’ button to create a new key


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:

  • gender

  • date of birth

  • country

  • city

  • state

  • zip_code

  • remote_id

  • job_title

  • phone_number

  • email_address

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.

Enter Credentials into Doozy

🖥️ Now go to our web app,, and sign into your account.


Choose Humaans as the HRIS you want to connect.

Follow the steps here.

Paste your Humaans API Key in Merge Link.