Asurint has been redefining how background searches are done; solving problems and reducing anxiety for recruiters and their candidates throughout the hiring process.
Using innovative tools that aid in faster turnaround times and more accurate information, Asurint provides the only background screen optimized to deliver the truth, on demand.
Greenhouse Recruiting’s integration with Asurint allows your organization to add an Asurint background check to a job's interview plan to assist efficient workflows with complete visibility of the hiring lifecycle.
Retrieve your Asurint credentials
Before enabling the Greenhouse/Asurint integration, you'll need the following pieces of information from Asurint.
- Asurint’s Endpoint URL
- Asurint’s Username and Password (necessary for webhook)
- Asurint Package ID Information
The Asurint implementations team will provide this information to your organization after a sales agreement has been signed.
If you are an existing client of Asurint, please reach out to Client Relations using the information below.
Configure custom fields for the Asurint integration
Note: To complete this part of the setup, you'll need to be a Site Admin or Job Admin with the Can manage custom fields user permission. Click here for more information on updating permissions.
The number of custom fields you must configure in Greenhouse Recruiting is dependent on your package options. Speak with your Asurint representative for more information on the needed custom fields.
Click here for more information on creating a custom field.
Note: The Immutable Field Key must exactly match the field required by Asurint and will generate once the custom field is saved. If the immutable field key does not match, the integration will not work.
Enable the Greenhouse Recruiting/Asurint integration
Create a webhook
To integrate Asurint 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 webhook:
- Name: Asurint Integration
-
When: The time that the event will be sent to Asurint. Select the following options for this integration:
- Candidate has been Hired
- Endpoint URL: The Endpoint URL received from the Asurint Client Implementations team
- Secret Key: Not used
- Username and Password: The Credentials received from the Asurint Client Implementations team
Create a Harvest API key
To configure the Greenhouse Recruiting / Asurint integration, you’ll need to create a Harvest API key.
Follow the steps in this article to create the key, and verify that the permissions below are selected when configuring the Asurint integration.
Credentials
In the Create New Credential box, make the following selections:
- API Type: Harvest
- Partner: COMPANY (optional)
- Description: COMPANY Harvest API Key
Permissions
Verify that the following permissions are selected for the Asurint integration:
Activity Feed
- Get: Retrieve Activity Feed
Applications
- Delete: Delete Application
- Get: Retrieve Application
- Get: List Applications
- Patch: Update Application
- Post: Advance Application
- Post: Hire Application
- Post: Move Application
- Post: Reject Application
- Post: Moves Application to Job
- Post: Unreject Application
Approvals
- Select all
Candidates
- Select all
Close reasons
- Select all
Custom Field Options
- Select all
Custom Fields
- Select all
Departments
- Select all
EEOC
- Select all
Education
- Select all
Email Templates
- Select all
Job Openings
- Select all
Job Posts
- Select all
Job Stages
- Select all
Jobs
- Select all
Offers
- Get: List Application Offers
- Get: Retrieve Application's Current Offer
- Get: Retrieve Offer
- Get: List Offers
Offices
- Select all
Rejection Reasons
- Select all
Scheduled Interviews
- Select all
Scorecards
- Select all
Sources
- Select all
Tags
- Delete: Remove tag from candidate
- Get: List tags applied to candidate
- Get: List candidate tags
- Put: Add a candidate tag
- Post: Add new candidate tag
Tracking Links
- Select all
User roles
- Select all
Users
- Select all
Click Save.
Greenhouse Recruiting will generate the API key and display it in a subsequent dialog box. Click Copy to save your API key to your clipboard. Please store the API key in a secure location for now. You will provide the API key in a further setup within Asurint's software.
Once the API key is stored securely on your local computer, click I have stored the API Key to close the dialog box.
Note: You cannot access the full API key again after clicking I have stored the API Key. If you lose your API key and need to access it later, you must create a new API key, provide it to the integration partner, and then revoke access to the original key.
Use the Asurint integration in Greenhouse Recruiting
Submit an order
When an offer is created for a candidate, use the Asurint Background Package dropdown menu within the Accept Offer modal to select a package.
Once the candidate is marked as Hired, an email link will be generated and sent directly to the candidate to complete the background forms.
View the results from an Asurint background request
When a candidate's background check is complete, the Activity Feed on the candidate profile will contain a log of the background check results complete with an:
- Asurint order ID
- Background check status
- Link containing the full Asurint report
Your team can then utilize the report link provided within the candidate Activity Feed to access the full report in Asurint.
Additional resources
Please contact your Asurint representative or contact support at support@asurint.com or 1.800.906.1674 for troubleshooting assistance regarding the integration.