---
title: HireRight
slug: hireright
docTags: rl7p3XLQknqPB1UQ70cu_,wz9SuR5IfsCQCCBMiGcNH
createdAt: 2025-07-10T11:42:30.303Z
---

The HireRight integration allows Ashby users to seamlessly add background check assessments to their hiring workflows. Prior to enabling the integration, please contact HireRight to have it set up on your HireRight Account. A HireRight Technical Consultant will contact you with instructions on how to install the integration in Ashby.

## Before Enabling the Integration

To enable the HireRight integration, follow these preliminary steps:

- Contact HireRight: Reach out to HireRight to set up the integration on your account. A HireRight Technical Consultant will guide you through the necessary steps.
- Receive API Credentials: After approval, the consultant will provide instructions for generating the API key required to authenticate the integration in Ashby.

***

## Enabling the Integration

Once your HireRight account is ready:

1. Log in to your Ashby account.
2. Visit the [HireRight Integration page](https://app.ashbyhq.com/admin/integrations/marketplace/hireright).
3. Click `Enable HireRight`.
4. Follow the authentication steps by entering:
   1. Adding Assessments: select how assessments should be added; we recommend `Configure in interview plan`
   2. HireRight Company Login: input the company login provided to you by HireRight
   3. Ashby API Key: generate an Ashby API key for the integration (save the key details, you won’t be able to access them again).

![](https://cdn.zappy.app/07a807098ac00701413be74b1af12da2.png)

## Configuring the Integration

You can configure the HireRight integration in the following ways:

### Configure in the Interview Plan (Recommended)

- Navigate to the Interview Plan of a job.
- Scroll to the relevant stage (e.g., Offer or Hired).
- Click `Add Activity`, then select HireRight under the Integration section.
- Choose the desired assessment package and, optionally enable automation to trigger the assessment when a candidate enters this stage.

![](https://cdn.zappy.app/751dd36cec8d5ae963f096a279a2b18f.png)

### Automatically Add to Specific Stages

- Configure assessments to be automatically added when a candidate moves into the Offer or Hired stage.
- This option is set during the initial integration setup.

![](https://cdn.zappy.app/5e74f5efe2d0de9f16e605ac98f9039e.png)

### Add Assessments Manually

- On a candidate profile, click `Add Activity` and select HireRight.
- Choose the assessment package to send an invitation to the candidate.

![](https://cdn.zappy.app/11acd83bd6788697b2b0d8574baa7a08.png)

## Using the Integration

### Sending Assessments

1. Move a candidate into the configured stage (e.g., Offer).
2. The HireRight activity will on their profile, or you can manually add using the `Add Activity` button. Click Start Assessment.
3. Fill in the necessary details, including job location.
4. Click Start to send the assessment invitation to the candidate.

### Monitoring Progress

- Assessment status updates appear directly in Ashby.
- Once completed, the adjudication status is displayed, with a button to access the detailed results.

***

## FAQ

:::ExpandableHeading
### What default fields are mapped?

The following fields are included in the data we provide

- Candidate
  - First Name
  - Last Name
  - Email
  - Phone Number
- Work Location
  - Country Code
  - Region
  - Municipality
  - Please note: zip code is not yet supported and will need to be provided each time an assessment is initiated.
:::

:::ExpandableHeading
### Can I change the assessment type after configuring it?

Yes, assessment types can be changed before sending the invitation.
:::

:::ExpandableHeading
### Do I need to configure assessments for each job?

Yes, configuring assessments in the Interview Plan for each job ensures a streamlined and automated process.


:::

:::ExpandableHeading
### I received an error message

If you receive an error message, you’ll see a transaction ID on the error. Please copy this ID and share with support when reaching out as it help to debug errors.
:::