Humantelligence is the leading cloud-based recruiting and culture analytics solution that leverages AI to significantly streamline the interview process, eliminate hiring subjectivity, improve the quality of hire, reduce turnover, drive engagement, and ensuring diversity. Greenhouse Recruiting has three different types of integrations with Humantelligence that your organization can leverage:
- Data synchronization integration: Enable the flow of data between Humantelligence and Greenhouse Recruiting.
- Self-assessment integration: Add Humantelligence - Team Culture Fit’s assessment to a job's interview plan.
- Sync with webhooks: Connect Greenhouse Recruiting and Humantelligence using webhooks
Create a Harvest API key for the Humantelligence integration
To configure the Greenhouse Recruiting / Humantelligence integration, you'll need to create a Harvest API key.
Follow the steps in this article to create the key, and verify that the credentials and permissions below are selected when configuring the Humantelligence integration.
Credentials
In the Create New Credential box, make the following selections:
- API Type: Harvest
- Partner: Humantelligence
- Description: Humantelligence Harvest API Key
Permissions
Verify that the following permissions are selected for the Humantelligence integration:
Applications
- GET: Retrieve Application
- GET: List Applications
- POST: Add Attachment to Application
Candidates
- GET: Retrieve Candidate
- GET: List Candidates
Departments
- GET: Retrieve Department
- GET: List Departments
Job Stages
- GET: Retrieve Job Stage
- GET: List Job Stages
- GET: List Job Stages for Job
Jobs
- GET: Retrieve Job
- GET: List Jobs
Offices
- GET: Retrieve Office
- GET: List Offices
Sources
- GET: List Sources
Users
- GET: Retrieve User
- GET: List Users
Provide the API key to Humantelligence in the below step.
Retrieve your Greenhouse Recruiting subdomain
To configure this integration, you'll need to write down your Greenhouse Recruiting subdomain. The subdomain can be found by looking at your Greenhouse Recruiting URL and copying the text directly before greenhouse.io.
For example, in the URL https://app5.greenhouse.io/dashboard, the subdomain is app5.
Finish setup in Humantelligence
Open Humantelligence and navigate to the Humantelligence Integration settings panel. Enter your Harvest API Key and Greenhouse Recruiting subdomain in the appropriate fields and click Save Settings.
Data synchronizations
Humantelligence Connect Integrations will periodically and automatically sync Humantelligence and Greenhouse Recruiting.
When the sync runs, Humantelligence will import and update users, departments, jobs, applications, and other data points from Greenhouse Recruiting.
You can also manually begin a sync in Humantelligence.
Configure the self-assessment integration
Humantelligence's scientifically proven 12-minute self-assessment and analytics platform measure culture at every level, uncovering talent insights that can be leveraged for improving performance, engagement, and hiring. Greenhouse Recruiting's self-assessment integration with Humantelligence allows you to seamlessly add Humantelligence - Team Culture Fit’s assessment to a job's interview plan.
To start, contact your Humantelligence representative to receive your API key. Once you have received your API key, fill out the form at www.greenhouse.io/asksupport or click here to open a ticket.
Note: Do not send the API key in this initial email.
The Greenhouse Technical Support team will respond with a SendSafely link for you to enter your API key. A notification will be sent to the Greenhouse Technical 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.
Note: To verify your identity, the Greenhouse Technical Support team might request you provide a Support Verification Code before adding the API key to your organization's account.
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 add the stage, modify the interview plan where you want to include the Humantelligence integration.
When you click Add Stage, a Humantelligence stage can be selected.
Configure Humantelligence Stage
Once the stage has been added to the job's interview plan, click Edit Take Home Test and choose assessment and grader.
Note: The available assessments, including any email templates or branding, are configured in Humantelligence.
Send and review an assessment
When candidates are moved into the Humantelligence interview stage, you can click the Send Test button to email an assessment to a candidate.
Note: Even though you are sending the email from Greenhouse Recruiting, the candidate will see the interview instructions are actually sent by Humantelligence.
After it's been sent, the assessment status will display in Greenhouse Recruiting.
Once the candidate has submitted their test, the recruiter or admin responsible for grading the test will receive an email notification with a link to the test.
Once the candidate finishes the assessment, the test results can be seen in the Humantelligence platform. The Humantelligence Talent Profile provides clear feedback and valuable insights instantly based on your results and can be used to develop and perform at each one’s best.
Sync Greenhouse Recruiting and Humantelligence with webhooks
Greenhouse Recruiting’s integration with Humantelligence uses Web Hooks to keep the two platforms in sync. When an event occurs in Greenhouse Recuiting, Humantelligence will get notified and your Humantelligence portal data will be updated accordingly.
Retrieve the Humantelligence Webhook Secret Key and API Key
Before enabling the Greenhouse/Humantelligence integration, you'll need to get the Webhook Secret Key and the Humantelligence API Key from the Humantelligence platform.
These values are listed on the Integration Credentials panel in Humantelligence.
Create a webhook
To integrate Humantelligence with Greenhouse Recruiting, you'll need to create a webhook. Follow the steps in this article to create your webhook. Use the values listed below to configure the webhooks.
You'll need to create three webhooks for the Humantelligence integration.
Webhook 1: New job
- Name: Humantelligence New Job
- When: Job Created
- Endpoint URL: https://portal.humantelligence.com/api/v1/ integrations/webhooks/positions
- Secret Key: Your Webhook Secret Key from the previous section
- Error recipient email: Your Humantelligence Portal Administrator
- Advanced Settings - Additional HTTP Headers: The Humantelligence API Key from the previous section
Webhook 2: New application
- Name: Humantelligence New Application
- When: Candidate has submitted application
- Endpoint URL: https://portal.humantelligence.com/api/v1/integrations/webhook/applications
- Secret Key: Your Webhook Secret Key from the previous section
- Error recipient email: Your Humantelligence Portal Administrator
- Advanced Settings - Additional HTTP Headers: The Humantelligence API Key from the previous section
Webhook 3: Candidate hired
- Name: Humantelligence Candidate Hired
- When: Candidate has been hired
- Endpoint URL: https://portal.humantelligence.com/api/v1/integrations/webhooks/employees
- Secret Key: Your Webhook Secret Key from the previous section
- Error recipient email: Your Humantelligence Portal Administrator
- Advanced Settings - Additional HTTP Headers: The Humantelligence API Key from the previous section
Additional resources
For additional information not covered here, reach out to support@humantelligence.com.