Permissions: Job Admin or higher

Product tier: Available to all subscription tiers

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 Configured_Icon.png icon > Users > Your Name.

Configure_-_Users.png

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.

AssureHire_permissions.png

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

Note: To configure custom options in Greenhouse Recruiting, you'll need to be a Site Admin or a Job Admin with the additional user-specific permission Can manage custom fields.

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.

Configure_-_Custom_Options.png

Click Candidates under the Company Custom Fields section.

Custom_Options___Candidates.png

From the Manage Candidate Fields page, click Add Field.

Add_custom_candidate_field.png

Make the following selections on your new custom candidate field:

  • Field Name: Background Report
  • Description: Background Report
  • Type: URL Field

Click Save.

Add custom job field

To add a custom job field, click Configure Configured_Icon.png icon and select Custom Options on the left.

Configure_-_Custom_Options.png

Click Jobs under the Company Custom Fields section.

Custom_Options___Jobs.png

From the Manage Job Fields page, click Add Field.

Add_custom_job_field.png

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 (see screenshot above).

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 Configured_Icon.png icon then select Dev Center on the left.

Configure-DevCenter.png

From the Dev Center page, click API Credential Management.

API_Credential_management.png

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.

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.

On the subsequent page, confirm the following permissions are assigned to your new API key:

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

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 support@assurehire.com 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 Configured_Icon.png icon and select Dev Center on the left.

Configure-DevCenter.png

From the Dev Center page, click Web hooks.

Webhooks.png

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.

Additional resources

For information not covered here, reach out to AssureHire Support at support@assurehire.com.