AssureHire leads the industry in technology and automation, resulting in the fastest end-to-end background screening, verifications, and drug testing experience.
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.
Set up the AssureHire integration
Configure custom options
To configure the AssureHire integration, you'll need to add both a custom candidate field and a custom job field in Greenhouse Recruiting.
Note: To configure custom options in Greenhouse Recruiting, you'll need to be a Site Admin or Job Admin with the additional user-specific permission 'Can manage custom fields'.
Add a custom candidate field
To add a custom candidate field for the AssureHire integration, click Configure and select Custom Options from the left-hand panel. Under Company custom fields, select Candidates and then, click Add field.
Make the following selections on your new custom candidate field:
- Field Name: Background Report
- Description: Background Report
- Type: URL Field
When finished, click Save.
Add a custom job field
To add a custom job field for the AssureHire integration, click Configure and select Custom Options from the left-hand panel. Under Company custom fields, select Jobs and then, click Add field.
Make the following selections on your new custom job field:
- Field Name: Background Package
- Description Background Package
- Type: Single select
Note: Be sure to add background check packages to the Options field with each package separated by a line break.
When finished, click Save.
Create a Harvest API key
Next, you’ll need to create a Harvest API key for the AssureHire integration.
Follow the steps in this article to create the key, and verify that the permissions below are selected when configuring the AssureHire integration.
Credentials
In the Create New Credential dialog box, make the following selections:
- API Type: Harvest
- Partner: AssureHire
- Description: AssureHire Harvest API Key
Permissions
Verify the following permissions are selected for the AssureHire integration:
Candidates
- GET: Retrieve candidate
- GET: List candidates
- POST: Add note
Users
- GET: Retrieve user
- GET: List users
Activity Feed
- GET: Retrieve activity feed
Custom Field Options
- GET: Custom field options
- POST: Create custom field options
- PATCH: Update custom field options
When finished, click Save.
Your Harvest API key for the 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 webhook
Next, you'll need to create a webhook for the AssureHire integration. Follow the steps in this article to create your webhook.
Note: Greenhouse Recruiting will need two pieces of information to setup a new webhook for your AssureHire integration: the AssureHire's Endpoint URL and AssureHire's Secret Key.
To retrieve this information, contact AssureHire Support and include the following subject line:
- Greenhouse Endpoint URL & Secret Key Request: [YOUR COMPANY NAME]
Once you receive the AssureHire Endpoint URL and Secret Key, you can create a new webhook. Use the values listed below to configure the webhook:
- 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.
The AssureHire integration is now configured and ready for use.
Use the AssureHire integration
Submit background check order
When candidates are moved into the Offer stage, 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.
Additional resources
For information not covered here, reach out to AssureHire Support at support@assurehire.com.