A-Check Global helps companies of all sizes hire great people. As the nation’s most successful woman-minority-owned employment screening company, A-Check Global provides superior customer care, accurate, compliant background screening and drug testing solutions, and user-focused, online interface technology to meet the unique requirements of employers and their candidates worldwide.

Greenhouse Recruiting’s integration with A-Check Global allows users to access and manage A-Check Global’s background screening services, all from the Greenhouse solution you already use. This includes submitting background check orders, tracking order progress, and viewing reports.

Configure user setup permissions in Greenhouse Recruiting

To configure the Greenhouse Recruiting/A-Check Global integration, you’ll need the developer permission Can manage ALL organization’s API Credentials.

To assign this permission, reach out to a Greenhouse user in your organization with Site Admin level permissions and the specific Can edit another user's advanced permissions role to have them update your account.

This permission can be updated by navigating to the Users page. (Configure icon > Users > Your Name)

Have that Site Admin click on the user to be edited and scroll to the Permissions section on the user page and expand the Developer Permissions dropdown menu.

Select Manage and configure web hooks in the Developer Permissions section and click Save.

Repeat as necessary for any other user that needs to set up the integration.

Configure custom options in Greenhouse Recruiting for the A-Check Global 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/A-Check Global integration, you'll need to add both custom candidate fields and custom job fields in Greenhouse Recruiting.

Add a custom candidate field

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

Click Candidates under the Company Custom Fields section.

From the Manage Candidate Fields page, click Add Field.

Make the following selections on your new custom candidate field:

  • Field Name: Background Check Status
  • Description: Background Check Status
  • Field Type: Short textbox

Click Save.

Repeat the above steps for adding a candidate field for the below 3 fields as well. There should be 4 total.

  • Field Name: Background Check Result
  • Description: Background Check Result
  • Field Type: Short textbox
  • Field Name: Background Check Report Link
  • Description: Background Check Report Link
  • Field Type: URL
  • Field Name: Background Check Last Updated
  • Description: Background CheckLast Updated
  • Field Type: Short textbox

Add a custom job field

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

Click Jobs under the Company Custom Fields section.

From the Manage Job Fields page, click Add Field.

Make the following selections on your new custom job field:

  • Field Name: Background Check Package
  • Description: Background Check Package
  • Field 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 for the Greenhouse Recruiting/A-Check Global integration

Note: To generate an API key, you must have the developer permission Manage ALL organization's API Credentials.

Click on the Configure icon Icon

Description automatically generated and select the Dev Center on the left panel.

Select API Credential Management in the Dev Center.

From the API Credential Management page, click Create New API Key to generate the API key for A-Check Global.

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

  • API Type: Harvest
  • Partner: (optional)
  • Description: A-Check Global Harvest API Key

Click Manage Permissions.

Graphical user interface, text, application, email

Description automatically generated

Click Copy to save your API key to your clipboard. Store the API key in a secure location to provide to A-Check Global in the next step.

Click I have stored the API Key once you have copied and saved the key.

Note: You won’t be able to view the API key after clicking I have stored the API Key. If you lose your API key or need to access it later, you’ll need to generate a new key and provide it to A-Check Global.

Select the checkboxes next to each permission box to associate it with the API key.

The following permissions are needed for the A-Check Global integration.

  • Candidates
  • Users
  • Jobs
  • Custom Fields
  • Custom Field Options
  • Activity Field

When you’re finished, click Save.

Your Harvest API key for the Greenhouse/A-Check Global integration is created and configured. Provide your Harvest API key to your A-Check Global onboarding team so they can set up the integration.

Create the A-Check Global webhook

To enable the Greenhouse Recruiting/A-Check Global integration, you’ll need the following information:

  • A-Check Global’s endpoint URL
  • A-Check Global’s secret key

To retrieve this information please contact A-Check Global Integration Support at IntegrationTeam@acheckglobal.com and include the following subject line:

  • Greenhouse Endpoint URL & Secret Key Request: [YOUR COMPANY NAME]

A-Check Global Integration Support will respond with the Endpoint URL and Secret Key needed to complete the webhook configuration in Greenhouse Recruiting.

Once you receive the A-Check Global endpoint URL and secret key, you can create a new webhook.

To enable the integration, click the Configure icon in the upper right corner and select the Dev Center on left panel.

Click Web Hooks on the Dev Center. Click Web Hooks again on the next page.

Select Web Hooks once more on the subsequent page.

Enter the following information in the next page to configure a new webhook:

  • Name: A descriptive name for your integration. Most customers choose A-Check Global Integration
  • When: The time that the event will be sent to A-Check Global. Select the following options for this integration:
    • Candidate has changed stage
  • Endpoint URL: The Endpoint URL provided by A-Check Global
  • Secret Key: The Secret Key provided by A-Check Global

When you finish, click Create Web hook.

Your Greenhouse Recruiting account and A-Check Global account can now communicate with each other through webhooks. Check out the next sections for information on how to use the integration.

Use the A-Check Global integration with Greenhouse Recruiting

Before proceeding to initiate background check requests, please make sure every Job has a Background Check stage in the Interview plan. If not, please add it to the Job before submitting candidates for a background request. You can find the option to add the Background Check stage by going to the Job Setup tab in each Job and clicking Interview Plan on the left side menu.

Submit background check order

When a candidate is moved into the Background Check stage in Greenhouse Recruiting, a link will be provided in the Candidate’s Activity Feed section.

Click on the link provided in the Candidate’s Activity Feed section to automatically bring up a new window with an order screen. Here, you can view/change the package and/or add any additional items as needed before. Once everything looks correct, submit the request!

Track the status of the background check

Once the background request has been submitted, you can view the status of the background check by navigating to the Details tab of the Candidate.

You can track the status of the background check by scrolling down and viewing the 4 fields provided below in the Additional Details section.

  • Background Check Status: This is the overall status of the background check
  • Background Check Result: This is the adjudication result of the background check. Action may be needed from client.
  • Background Check Report Link: URL for accessing the candidate’s background check report. Users will need to login to see the results. Can be viewed while still in progress.
  • Background Check Last Updated: Date and time of when the last update for the background check was.

Notes will also be added to the Activity Feed tab and section as updates are made to the background check.

Additional resources

Please contact IntegrationTeam@acheckglobal.com for troubleshooting assistance regarding the integration.