AssureHire leads the industry in technology and automation, resulting in the fastest end-to-end background screening, verifications, and drug testing experience.
You can onboard faster, delight candidates, protect your data, and spend less time waiting for your checks to complete with AssureHire — a platform, team, and provider that clients trust.
Greenhouse Recruiting's integration with AssureHire makes it simple to manage the entire screening process in one system: submit background check orders, send candidate screening invites, track progress, view reports, and even initiate adverse action.
In this article, we will cover how to:
Configure user setup permissions in Greenhouse Recruiting
In order to enable the Greenhouse Recruiting / AssureHire 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 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 the permissions Can manage ALL organization's API Credentials and Can manage and configure webhooks so that a check is in each checkbox.
When finished, click Save.
Repeat as necessary for any other user that should have access to set up the integration.
Configure custom options in Greenhouse Recruiting for the AssureHire integration
To configure the Greenhouse Recruiting / AssureHire integration, you'll need to add both a custom candidate field and a custom job field in Greenhouse Recruiting.
Add custom candidate field
To add a custom candidate field, click Configure icon and select Custom Options on the left.
Click Candidates under the Company Custom Fields section.
From the Manage Candidate Fields page, click Add Field.
Make the following selections on your new custom candidate field:
- Field Name: Background Report
- Description: Background Report
- Type: URL Field
Add custom job field
To add a custom job field, click Configure icon and select Custom Options on the left.
Click Jobs under the Company Custom Fields section.
From the Manage Job Fields page, click Add Field.
Make the following selections on your new custom job field:
- Field Name: Background Package
- Description Background Package
- Type: Single select
When finished, click Save.
Create a Harvest API key and webhook for the Greenhouse Recruiting / AssureHire integration
Create a new Harvest API key
To create a Harvest API key for the Greenhouse Recruiting / AssureHire integration, click Configure icon then select Dev Center on the left.
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 AssureHire.
In the Create New Credential dialog box, make the following selections:
- API Type: Harvest
- Partner: AssureHire
- Description: AssureHire Harvest API Key
When finished, click Manage Permissions to generate the Harvest API key and automatically assign it the appropriate permissions required by AssureHire.
In the subsequent dialog box, click Copy to save your API key to your clipboard. Store the API key in a secure location to provide to AssureHire in the next step. Click I have stored the API Key once you have copied and saved the key.
On the subsequent page, confirm the following permissions are assigned to your new API key:
- GET: Retrieve candidate
- GET: List candidates
- POST: Add note
- GET: Retrieve user
- GET: List users
- GET: Retrieve activity feed
Custom Field Options
- GET: Custom field options
- POST: Create custom field options
- PATCH: Update custom field options
If any of the permissions above are not checked, place a check in the box next to the appropriate permission.
When finished, click Save.
Your Harvest API key for the Greenhouse Recruiting / AssureHire integration is created and configured. Provide your Harvest API key to your AssureHire onboarding team so they can finish setting up the integration.
Create a new webhook
Greenhouse Recruiting will need two pieces of information to setup a new webhook for your AssureHire integration:
- AssureHire's Endpoint URL
- AssureHire's Secret Key
To retrieve this information please contact AssureHire Support at firstname.lastname@example.org and include the following subject line:
- Greenhouse Endpoint URL & Secret Key Request: [YOUR COMPANY NAME]
AssureHire Support will respond with the Endpoint URL and Secret Key needed to complete the webhook configuration in Greenhouse Recruiting.
Once you receive the AssureHire Endpoint URL and Secret Key, you can create a new webhook.
To create a webhook for the Greenhouse Recruiting / AssureHIre integration, click Configure icon and select Dev Center on the left.
From the Dev Center page, click Web hooks.
Select Web Hooks once more on the subsequent page.
On the Create a New WebHook, enter the following details:
- Name: AssureHire Integration
- When: Candidate has changed
- Endpoint URL: https://assurehire.com/partners/greenhouse/webhook
- Secret Key:
Enter the Secret Key provided by AssureHire Support
When finished, click Create Webhook.
Your Greenhouse Recruiting and AssureHire integration is now configured and complete.
Use the Greenhouse Recruiting / AssureHire integration
Submit background check order
When candidates are moved into the Offer stage in Greenhouse Recruiting, a background check order will automatically trigger from AssureHire.
If a candidate is not in an Offer stage, the background check order has not been initiated yet.
Track status of background check order
Once you've moved the candidate into the Offer stage, the background check is automatically ordered.
You can track the status of the background check by clicking the Activity Feed on the candidate profile in Greenhouse Recruiting.
To view the status of a background check, click the link in the Activity Feed note from AssureHire.
View final background check report
Once a background check report is completed, AssureHire will send you an email notification with a link to click on the final report.
AssureHire also posts a status update in the candidate's Activity Feed with a link that when clicked will allow you to view the final background check report as well.
The completed background check report is also attached to the candidate's Details tab in Greenhouse Recruiting.
Click the AssureHire URL below Background Report to view the final report in AssureHire.
For information not covered here, reach out to AssureHire Support at email@example.com.