Global HR Research (formerly Swifthire by ESS) integration

Global HR Research (formerly Swifthire by ESS) allows you to send background screening requests directly to job applicants, students, or even volunteers, rather than having to input applicant information yourself. Global HR Research is built right into your client ordering module featuring an electronic consent form and all of the following benefits.

Greenhouse Recruiting's integration with Global HR Research allows you to send Global HR Research assessments to candidates within Greenhouse Recruiting.

Retrieve Global HR Research endpoint URL and secret key

Before enabling the Global HR Research integration, Greenhouse Recruiting will need two pieces of information:

  • Global HR Research endpoint URL
  • Global HR Research secret key

To retrieve this information, reach out to your Global HR Research customer success manager.

Enable the Global HR Research integration

Create a webhook

To integrate Global HR Research 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 webhooks.

  • Name: Global HR Research integration
  • When: Candidate has changed stage
  • Endpoint URL: The Endpoint URL provided by Global HR Research
  • Secret Key: The Secret Key provided by Global HR Research
  • Username: Secret Key received from the Global HR Research

When finished, click Create Webhook.

That's it! Your Global HR Research integration is enabled.

Create custom candidate fields

To create custom candidate fields for the integration, click Configure > Custom Fields > Candidates. Then select Add Field.

Create separate custom candidate fields for each of the following:

Field name Field type
Background Check Status Short Textbox
Background Check Result URL
Background Check Completed Date Short Textbox

Check out this article for detailed instructions on creating custom candidate fields.

Create custom job fields

To create custom candidate fields, click Configure > Custom Fields > Jobs. Then select Add Field.

Create separate custom job fields for each of the following:

Field name Field type Options Required
Background Check Package Single Select List all available packages on individual lines Yes
Background Check Location Single Select List all available locations on individual lines Yes

Check out this article for detailed instructions on creating custom job fields.

This configuration allows you to select the background check package and location necessary to complete the background check. In order to use the integration, it's necessary to select the package and location for each job in Greenhouse Recruiting.

Use the Global HR Research integration with Greenhouse Recruiting

Add Global HR Research to your job's interview plan

Once the integration is enabled for your organization, you'll be able to add Global HR Research as an interview stage.

To do this for an existing job, navigate to your job (Jobs > Job Name) and click Job Setup > Interview Plan.

Click+ Add a Stage. Select the Global HR Research stage.

When finished, click Add.

Hover over the stage to click Edit, then select the background check and assign reviewers for the assessment.

Send and review the background check

When candidates are moved into the Global HR Research interview stage, Greenhouse Recruiting will display a Send Test link on their candidate profile.

Note: When you send a background check request from Greenhouse Recruiting, the instructions are actually sent by Global HR Research.

When sending the background check, provide the candidate's email and select which question profile applies to the job the candidate is applying for.

Click Send Test, and the candidate will receive an email to initiate the background check process.

Once the candidate completes the request, the report will be available for viewing within Greenhouse Recruiting on the candidate profile.

On the candidate scorecard / interview kit, click View Report to be taken to Global HR Research for full results.

Global HR Research integration image