---
title: SHL
slug: shl
docTags: rl7p3XLQknqPB1UQ70cu_,wz9SuR5IfsCQCCBMiGcNH
createdAt: 2025-07-10T11:42:30.304Z
---

This guide will walk you through integrating your SHL account with Ashby, allowing you to use SHL assessments in your interview plans and retrieve the results all from within the Ashby platform.

:::hint{type="warning"}
**Prerequisites:**

Customers should first engage with SHL to scope the integration and execute the required Statement of Work (SOW) before following the steps below. An implementation fee may apply depending on the engagement.

Client credentials (Client ID and Client Secret) are provisioned only after the SOW has been signed and the implementation project has commenced.
:::

## Setting up the integration

- Navigate to the [SHL integration](https://app.ashbyhq.com/admin/integrations/marketplace/shl) in Admin
- Select your account’s region
- Select the way you’d like to add assessments to candidate profiles (see [Using the Integration](docId\:Fq9BQv8bqfEYwR8rCpEyn) for more information)
- Input your SHL `Client Secret` and `Client ID` (you may need to get in touch with SHL for this)
- Generate an Ashby API Key (more on this at [How do I generate an API key?](docId\:Bd5mE2TCmTYHK-vUJLHdZ))
- If you’re not an partner, please ignore the staging base URL field

![CleanShot 2025-05-26 at 09.34.33@2x.png](https://api.archbee.com/api/optimize/0p8tQ--ZZOxRtkVp6Qr-e/FpqxCQc2XUrCgKyM38Crv_cleanshot2025-05-26at0934332x.png)

## Using the integration

There are three configuration options:

- Adding background check requests as a one-off
  - From the candidate profile, click `Add Activity` to generate an SHL activity. Then, follow the steps on the activity that appears.
- Configuring them on the interview plan
  - Visit the settings of a job and add the activity to the reference check stage of your interview plan. When a candidate enters the stage the activity will appear you can manually complete the steps to send the request, or when the card
- Automatically adding the assessment to offer or hired stages
  - Choose the stage you’d like to include the activity on while configuring the integration. When a candidate enters the designated stage, the corresponding activity will appear.

## Viewing the results

- When the package has been completed, the activity's status will be updated. The hiring team will receive notifications as the status changes.
- There will be a link to the results on the activity upon completion.

## FAQ

:::ExpandableHeading
### What SHL statuses are supported?

- Not Started
- In Progress
- Complete
:::

:::ExpandableHeading
### What permissions does the Ashby API Key need?

The SHL integration would require read/write access for candidates on the Ashby API key. These permissions are pre-defined and don’t need to be modified.
:::