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.