How can we help you?

Humantelligence

 

Humantelligence is the leading cloud-based recruiting and culture analytics solution that leverages AI to significantly streamline the interview process, eliminate hiring subjectivity, improve quality of hire, reduce turnover, drive engagement and ensuring diversity.

In this document we’ll have a look at 3 types of Integrations between Greenhouse and Humantelligence.

 

 

  1. Data Synchronisation

 

Greenhouse Recruiting’s integration with Humantelligence allows to enable the flow of data between Humantelligence and Greenhouse. In this section, we will cover how to:

 

  • Configure User Setup Permissions in Greenhouse Recruiting
  • Create a Harvest API Key for the Greenhouse/Humantelligence Integration
  • Set up Humantelligence Integration settings with Greenhouse’s credentials
  • Run Greenhouse data sync with Humantelligence

 

Configure User Setup Permissions in Greenhouse Recruiting

In order to enable the Greenhouse/Humantelligence 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 ALL organization’s API Credentials 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.

Create a Harvest API Key for the Greenhouse/Humantelligence Integration

To create a Harvest API key for the integration, click on the Configure icon Screen_Shot_2018-05-24_at_5.31.51_PM.png in the upper right-hand corner. Navigate to Dev Center on the left-hand panel.

From the Dev Center page, click API Credential Management.

 

From the API Credential Management page, click Create New API Key to generate the API key for Humantelligence.

 

 

From the Create new credential dialog box, give your API key a name and select Harvest from the Type dropdown menu. When finished, click Create.

 

 

On the Manage API Key Permissions page, enable ALL permissions. When finished, click Update.

 

 

Your Harvest API key for the Greenhouse/Humantelligence integration is created and configured.

 

Set up Humantelligence Integration settings with Greenhouse’s credentials

 For that we will need two pieces of information from your Greenhouse account:

 

Greenhouse Subdomain

If you access https://acme.greenhouse.io, then your subdomain is acme.

 

Greenhouse API Key

Follow the steps shown above to access the API Credential Management section of your Greenhouse account.

 

Then we can just set up the Integration inside Humantelligence Integration settings panel.

 

 

 

Run Greenhouse data sync with Humantelligence

Humantelligence Connect Integrations will keep in sync Humantelligence with Greenhouse.

The sync will run periodically and automatically import and updates Greenhouse’s Users, Departments, Jobs as well as the Candidates Applications.

 

 

We can also run the sync manually and decide which import we want to run from Full Import that will pull all data from Greenhouse as well as for example if we just want to sync the Candidates

 

 

 

  1. Self-Assessment Integration

 

Humantelligence scientifically proven 12-minute self-assessment and analytics platform measures culture at every level, uncovering talent insights that can be leveraged for improving performance, engagement, and hiring.

 

Greenhouse Recruiting's integration with Humantelligence allows you to seamlessly add Humantelligence - Team Culture Fit’s assessment to a job's interview plan.

In this section, we will cover how to:

 

  • Enable the Greenhouse/Humantelligence Integration
  • Add Humantelligence Stage to Job’s Interview Plan
  • Configure the Humantelligence Stage
  • Send and Review the Test

 

Enable the Greenhouse/Humantelligence Integration

To start, contact your Humantelligence representative (email) to receive your API key. Once you have received your API key, email support@greenhouse.io or click here to open a ticket.

Note: Do not send the API key in this initial email.

The Greenhouse Support Team will respond with a SendSafely link for you to enter your API key. A notification will be sent to the Greenhouse Support Team after you have entered your API key and they will email you to confirm that your API key has been set up in your account and your integration is enabled.

 

Add Humantelligence Stage to Job’s Interview Plan

Once the Greenhouse/Humantelligence integration is enabled for your organization, you will be able to add the Humantelligence assessment as an Interview stage. 

To do this for an existing job, navigate to a job (All Jobs>Job Name) and click Job Setup from the Job navigation bar.

From the Job Setup page, navigate to Interview Plan on the left-hand panel. Scroll down the page and click + Add a Stage.

Screen%20Shot%202018-07-23%20at%209.10.09%20AM.png

From the Add Stage dialog box, select the Humantelligence stage. When finished, click Add to apply the stage to the job's interview plan.

 

 

Configure Humantelligence Stage

Once the stage has been added to the job's interview plan, click Edit Take Home Test. Use the provided drop-down menu to choose assessments that you have previously set up in Humantelligence. 

Select the appropriate assessment and assign at least one Greenhouse user to grade/review submitted assessments. When finished, click Save.

Note: Keep in the mind that all configuration of the assessment itself, as well as the email template, will need to be done in Humantelligence. 

 

Send and Review the Test

When candidates are moved into the Humantelligence interview stage, Greenhouse will display a Send Test link.

Note: When you send a test from Greenhouse, the interview instructions are actually sent by Humantelligence.

 

 

 

The status of the assessment will be viewable in Greenhouse:

 

 

Once the candidate has submitted their test, the recruiter or admin responsible for grading the test will receive a notification with all the necessary information.

 

 

Then in Greenhouse the Interview Kit will contain a link to view the results of the submitted test on Humantelligence.

 

Humantelligence Talent Profile, instantly based on your results, provides clear feedback and valuable insights that can be used to develop and perform at each one’s best.

 

 

 

  1. Web Hooks Integration

 

Greenhouse Recruiting’s integration with Humantelligence uses Web Hooks to keep the 2 platforms in sync.

 

A web hook is a simple event notification system. When an event occurs in Greenhouse, Humantelligence will get notified and your Humantelligence portal data will be updated accordingly. In this article, we will review the steps necessary to enable an integration between Greenhouse Recruiting and Humantelligence and create two web hooks, one for when a new Job is created in Greenhouse and one for when a new Candidate applies for a job.

 

  • Retrieve Humantelligence’s web hooks Secret Key and API Key
  • Configure User Setup Permissions in Greenhouse Recruiting
  • Enable Greenhouse/Humantelligence web hooks Integration

 

Retrieve Humantelligence’s web hooks Secret Key and API Key

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

  • Humantelligence’s web hooks Secret Key
  • Humantelligence’s API Key

 To retrieve this information please log in to your Humantelligence portal and go to the Integration Credentials panel.

 

 

 

Configure User Setup Permissions in Greenhouse Recruiting

After you have received your endpoint URL and Secret Key from Humantelligence, 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.

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.

 

 

Enable Greenhouse/Humantelligence web hooks Integration

 

With Humantelligence’s Secret Key copied, and your Greenhouse user permissions enabled, you are ready to enable the Greenhouse/Humantelligence 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.

 

Create Web Hooks

You are now ready to configure the first web hook.

 

 

 

 

Creating a WebHook

 

Web hooks have three main components: a Name, an Endpoint URL, and a Secret Key.

 

WebHook: New Job

 

  1. Enter the name for this web hook: New Job
  2. Select When: Job Created
  3. Enter this Endpoint URL: https://portal.humantelligence.com/api/v1/integrations/webhook/positions
  4. Enter the Secret Key that you retrieved earlier.
  5. The Error recipient email should be your main Humantelligence Portal administrator.
  6. Make sure the web hook is not disabled.
  7. Click on Advanced settings...

We have added some advanced settings for extra security. Have a look at the next screenshot.

 

  1. Enter the Additional HTTP Headers.

This is where you’ll enter the Humantelligence API Key that you retrieved earlier. It will look something like X-HT-ApiKey: 5a44164c69dfghb92k000703.

  1. Finally, click Create Web Hook.

 

 

Web Hook: New Application

 

You’ll repeat the same steps for the second web hook.

 

  1. Enter the name for this web hook: New Application
  2. Select When: Candidate has Submitted Application
  3. Enter this Endpoint URL:

https://portal.humantelligence.com/api/v1/integrations/webhook/applications

  1. Enter the same Secret Key that you retrieved earlier..
  2. Enter the same Error recipient email.
  3. Make sure the web hook is not disabled.
  4. Click on Advance settings... 
  5. Add the same Additional HTTP Headers as the first web hook.
  6. Finally, click Create Web Hook.

 

 

Web Hook: Candidate Hired

 

Finally we’ll convert Hired candidates to an employee inside Humantelligence and set everything up for you. Once again, simply repeat the same steps as the second web hook.

 

  1. Enter the name for this web hook: Candidate Hired
  2. Select When: Candidate has been hired
  3. Enter this Endpoint URL:
  1. https://portal.humantelligence.com/api/v1/integrations/webhook/employees
  1. Enter the same Secret Key that you retrieved earlier..
  2. Enter the same Error recipient email.
  3. Make sure the web hook is not disabled.
  4. Click on Advance settings... 
  5. Add the same Additional HTTP Headers as the other web hooks.
  6. Finally, click Create Web Hook.

 

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


After using the integration, you may decide you want to share more info between Greenhouse and Humantelligence. If you would like additional information transferred over, please reach out to Humantelligence Customer Success with a list of items to add!