1. Greenhouse Support
  2. All Recruiting topics
  3. Integrations
  4. Candidate background check

Amiqus integration

Amiqus is a leading provider for businesses managing high-volume onboarding, enabling digital verification of new employees and candidates in minutes. The platform is an accredited Identity Service Provider (IDSP) for Right to Work and a registered DBS umbrella body, providing a faster and more compliant hiring process.

Amiqus’ integration with Greenhouse Recruiting allows users to seamlessly add Amiqus’ background checks as a stage in a job's interview plan.

In this article

Enable the integration

To enable the integration, you’ll need:

  1. To have the integration enabled on Amiqus. Email support@amiqus.co to request this feature.
  2. To be an admin user on Amiqus.
  3. To have the "Can manage ALL organisation's API Credentials" permission on Greenhouse. You can learn more about permission levels here.
  4. Amiqus will need a Greenhouse Recruiting user ID to associate with updates and changes created by the integration.

Locate a user ID

Click the Configure icon on your navigation bar and then click Users on the left. 

Click Export to Excel.

A spreadsheet will be downloaded to your computer. Open the Excel file and locate the user ID in the User ID column.

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 Amiqus integration.

Credentials

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

  • API Type: Harvest
  • Partner: Amiqus
  • Description: Amiqus Harvest API Key

Permissions

Verify that the following permissions are selected for the Amiqus integration:

  • All Permissions

Generate a job board API key

Follow the steps in this article and use the information below when creating your API key:

  • API Type: Job Board
  • Partner: Amiqus
  • Description: Amiqus job board API key

Click here for more detailed information on setting up a job board API key for a partner.

Set up the integration in Amiqus

Once you have all the above, navigate to the Workflow>Team apps area of your Amiqus account (https://id.amiqus.co/team/workflow/apps)

Click Connect Greenhouse account. 

Copy your External Trigger Token and store it somewhere – you’ll need it later.

Enter the rest of the information in the pop-up window and click Connect.

Follow the steps in this article to work with Greenhouse support representative and add the assessment stage in your interview plans. You’ll need to securely send them the API key you copied from Amiqus.

Create templates in Amiqus

Before you can send requests from Greenhouse, you'll need to have at least one Live request template set up in Amiqus, from which to select from. You can find information you need to create request templates in the following articles:

Please note that any messaging within your templates will be the same for all candidates; there are no dynamic fields within the messaging (eg for the candidates name).

Use the Amiqus integration

Once the Amiqus integration is enabled for your organization, you will be able to add the Amiqus Background check as an interview stage.

You can send this to a candidate by selecting the Send Test button next to the interview stage. The assessment instructions will be sent by Amiqus.

  1. In the Interview Plan of a new job or when editing a current job, select Add Stage.
  2. Choose Amiqus and click Add. Then move this stage to the place in the plan you would like the Amiqus Request to be sent. You can change the order of stages in an interview plan by clicking and dragging on the stage name. 
  3. Optionally, once the stage is in the interview plan, you can modify it by selecting the pencil icon next to the stage name. Here you can select the specific background check template from your Amiqus account.
  4. Whenever a candidate reaches this stage, the Send test to candidate option will be ready to select.
  5. After it has been sent, an assessment’s status will display in Greenhouse Recruiting.

Set up notifications

If you would like to receive notifications on the check status, we recommend assigning yourself and/or a colleague to the person and/or request in Amiqus, that way you'll be notified when the candidate completes the request.

You can do this on an individual basis within each person or request, or you can set this up within a request template.

You can customise your notification settings at any time, choosing from in app and/or email notifications.

Check results

Once the candidate has completed their request, they'll be marked as Ready for Review in Amiqus. Once you are happy with the check results, you will need to mark the request as Reviewed.

Once the check has been marked as Reviewed, the assessment's status will be sent to Greenhouse and iinclude a link to view the background check in Amiqus.

Additional resources

For additional information not covered here, reach out to support@amiqus.co.

The Amiqus Support Centre contains information about all check types including how to review the results. A few of the common check types have been listed below:

For full details on setting up and using this integration to initiate background checks, see Amiqus’ support article here.