Greenhouse Recruiting's integration with Sterling RISQ allows your organization to initiate orders for background screenings, check the status of orders, and view screening results right within Greenhouse Recruiting. 

Greenhouse Recruiting’s integration with Sterling RISQ allows users to create and initiate a background check for a candidate.

Set up the Sterling (RISQ)(APAC) integration

Configure your webhook oauth credentials

To integrate Sterling RISQ with Greenhouse Recruiting, you’ll need to create the webhook oauth credentials to use when configuring the webhook.

  • ConfigureDev CenterWeb HooksWeb Hook OAuth Credentials

Once on this screen, the user must input the below to configure OAuth for their client:

  • Name this credential: Name of the oauth token credentials, Sterling RISQ OAuth
  • Oauth token URL: URL of oauth token generated
  • Client ID: Sterling RISQ will provide the username to generate the OAuth token
  • Client secret key: Sterling RISQ will provide the password to generate the OAuth token
  • Grant Type: Select Client Credentials from the dropdown

Create a webhook

Once configured with the OAuth token credentials, follow the steps in this article to create your webhook. Use the values listed below to configure the webhook:

  • Name: A descriptive name for your integration. Most customers choose 'Sterling RISQ integration'
  • When: Candidate has changed stage
  • Endpoint URL: The Endpoint URL provided by Sterling RISQ
  • Secret key: Keep it blank
  • Error recipient email: Configure the email ID in case any error needs to be received
  • Advanced settings: Keep all the settings as default. In the OAuth dropdown, select the Oauth you have created
  • Disabled: No

Create a Harvest API key

Next, you'll also need to create a Harvest API key to enable the Greenhouse Recruiting / Sterling RISQ integration.

Follow the steps in this article to create the key, and verify that the credentials and permissions below are selected when configuring the Sterling RISQ integration.

Credentials

In the Create New Credential box, make the following selections:

  • API type: Harvest
  • Partner: Sterling RISQ (optional)
  • Description: Sterling RISQ Harvest API key

Permissions

Verify that the following permissions are selected for the Sterling RISQ integration:

Candidates

  • All permissions

Jobs

  • All permissions

Job Posts

  • All permissions

Users

  • All permissions

Custom Fields

  • All permissions

Custom Field Options

  • All permissions

Custom Locations

  • All permissions

Save when finished.

Your Harvest API key for the Sterling RISQ integration is created and configured.

Use the Sterling RISQ integration with Greenhouse Recruiting

Initiate an order 

Once you’ve successfully configured your Sterling RISQ integration, you can start initiating orders directly from Greenhouse Recruiting. 

To initiate the background check of a candidate, you’ll need to move the candidate to the configured  Background Check stage created during the integration setup. 

Note: If your organization would like to use a different stage name for the Sterling RISQ integration, reach out to your Sterling RISQ integration manager during the requirement scoping session to request changes.

After advancing the candidate to the Background check stage, a new order in Sterling RISQ is created with the order ID. The details of the case will be reflected on the Private tab within the candidate profile.

The case details will update on the Private tab when the Sterling RISQ order status changes from In Progress or Case Submitted.

Review order status 

Case Submitted

In Progress

Once the background check order is completed Sterling RISQ will post back the status, score and report URL back to Greenhouse Recruiting.

Additional resources

Frequently asked questions

Does background check information stay on a candidate’s profile permanently or are there cases where it will be deleted?

Each background check report is a standalone unit; Each report remains on record for 7 years. In some cases, it may be deleted earlier, either because deletion is required by applicable local law, or because the deletion is requested by the candidate or the end user of the report and Sterling RISQ is not subject to a legal or third-party obligation to retain the order.

Who is notified by Sterling RISQ when a background check is complete and how are they notified? Do you have example screenshots of this?

Email notifications can be set up in the AMY Awesome platform. In Greenhouse, to view the report, authorized Sterling users will be able to do so by accessing the completed report link in the private tab.

Does the integration support international background checks?

International background checks are supported on the Amy Awesome platform.

What permissions does a user need to export a candidate to Sterling RISQ?

User permissions are controlled by the employer and account settings in AMY Awesome platform.

What permissions does that user need to view the results in Sterling RISQ?

Permissions are controlled by the employer and account settings in Sterling. Sterling RISQ will post back the case overall status and score to Greenhouse for all orders. The viewing rights within Greenhouse are not controlled by Sterling RISQ.

Get in touch

For questions regarding pricing or activating your Sterling RISQ account, contact info@sterlingrisq.com.

For troubleshooting assistance regarding the integration, contact risqintegrations@sterlingrisq.com