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.