Humaans is an HRIS built to be the foundation layer of the organisation’s HR tech stack. It helps teams onboard and manage their employees through fast workflows, automation and quick access to data.

Designed for speed, it features a beautiful people directory, document storage, time off tracking, visual reporting, and integrates with many tools you already use.

Greenhouse Recruiting’s integration with Humaans allows you to automatically import hired candidates from Greenhouse to Humaans. In this article, we will cover how to:


  • Configure User Setup Permissions in Greenhouse Recruiting
  • Retrieve Humaans’s Endpoint URL and Secret Key
  • Enable Greenhouse/Humaans Integration
  • Import hired candidates into Humaans


Configure User Setup Permissions in Greenhouse Recruiting

In order to enable the Greenhouse/Humaans integration, you will need the developer permission Can manage ALL organization’s API Credentials.

Contact a Greenhouse user in your organization with Site Admin level permissions with the additional user-specific permission Can edit another user's advanced permissions to apply the API credential management permission to your account. Have the user with Site Admin level permissions edit your user account's permissions by navigating to the Configure icon   > Users > Your Name)

The user with Site Admin level permissions should navigate to the Permissions panel on your user page and expand the Developer Permissions dropdown menu. 

Select Can manage and configure web hooks so that a check is in the checkbox. When finished, click Save.

Repeat as necessary for any other user that should have access to set up the integration.

Retrieve Humaans Endpoint URL and Secret Key


Before enabling the Greenhouse/Humaans integration, Greenhouse will need two pieces of information:


  • Humaans Endpoint URL
  • Humaans Secret Key


To retrieve this information please open the Admin area in the Humaans app. You will need to have an Owner or Admin role to set up the integration. In the Admin area, find the Integrations section and click Configure in the Greenhouse entry.



To enable the integration, click Enable integration button:


And that will provide you with the Endpoint URL and Secret Key as shown below:




Enable Greenhouse/Humaans Integration


With Humaans endpoint URL and Secret Key copied, and your Greenhouse user permissions enabled, you are ready to enable the Greenhouse/Humaans integration.


To enable the integration, click the Configure icon  in the upper right-hand corner and navigate to Dev Center on the left-hand panel.



From the Dev Center page, click Web Hooks. Click Web Hooks from the subsequent page.


You will be directed to a new page where you Create a New Web Hook. From this page provide the following details:

  • Name: we suggest Humaans Integration
  • When: Be sure to select the right web hook so that the web hook fires at the appropriate event in Greenhouse: Candidate has been hired
  • Endpoint URL: The Endpoint URL received from Humaans
  • Secret Key: The Secret Key received from Humaans

When finished, click Create Web hook.


That's it! Your Greenhouse account and Humaans account can now talk to each other.


How to use the Humaans Integration with Greenhouse


Whenever a candidate is marked as hired in Greenhouse, they will get imported into Humaans and will appear under the New hires tab in the People directory:



From there, you will be able to either remove the new hires or add them as a member to your company.


Below is a list of fields that get imported from Greenhouse.


Greenhouse field Humaans field
First name First name
Last name Last name
Personal email Personal email
Mobile phone or Home phone Personal phone
Home address Address
Internal job name Job title
Department Department
Office Place of Work
Employment type Contract type
Start date Employment start date


Note: Place of work will be synced by matching the Office name in Greenhouse to the Location label/city in Humaans. If no match is found, the location will not be imported and you will be ale to select the location when adding the new hire as a member.


Need Help?


Please contact for troubleshooting assistance regarding the integration.