---
title: Xref
slug: xref
docTags: rl7p3XLQknqPB1UQ70cu_,wz9SuR5IfsCQCCBMiGcNH
createdAt: 2025-07-10T11:42:31.263Z
---

The Xref integration supports generating reference requests using the email address associated with a candidate’s profile.

### Setting up the integration

- Log into your Xref account and find the Ashby integration to collect your API key.
- Log into Ashby (Org Admin) and visit the [Integrations Marketplace](https://app.ashbyhq.com/admin/integrations/marketplace)
- Find the [Xref integration](https://app.ashbyhq.com/admin/integrations/marketplace/633e9c08-df83-488e-a163-a4181283ae71), generate an Ashby API key, and input your Xref API key.
- You can choose to configure the activity on the interview plan or automatically the XRef activity for the Offer or Hired Stage of all interview plans.

### Using the integration

There are three configuration options:

- Adding reference requests one-off
  - From the candidate profile, click `Add Activity` and generate an Xref activity. 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 on their profile. From there, you can manually complete the steps to send the request.
- 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 all references have 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.