Virvell × Ashby Integration

Virvell adds three AI-powered screening services to Ashby — pre-screen interviews, voice reference checks, and background verification — that you can trigger directly from a candidate's profile. Results write back to Ashby as structured assessment data. No copy-paste, no switching tools.

Before you start

• An active Virvell account. If you don't have one yet, sign up at virvell.ai or contact support@virvell.ai.
• Admin access to your Ashby workspace (you'll need to create an API key).
• Estimated setup time: under 5 minutes.

Setting up the integration

1. 1

   Sign in to Ashby and navigate to Admin → API Keys

   In the left sidebar, expand Integrations and click API Keys. You'll see a list of your existing API keys.

   

   The API Keys page in Ashby admin.

2. 2

   Click + New to create a new API key

   Click the + New button in the top right. In the dialog, enter a name for the key (e.g., Virvell). Under Integration Partner, select Virvell from the dropdown if available, or leave it blank.

   

   The Create API Key dialog.

3. 3

   Set permissions

   Grant the key these permissions: Candidates — Read and Write. Scroll down or check the permissions panel to confirm both Read and Write are enabled for Candidates. Applications — Read is also needed. Click Save when done.

   

   API key permissions. Enable Candidates Read + Write.

4. 4

   Copy the API key

   Ashby will show the key once. Copy it immediately — you won't be able to see it again.

5. 5

   Paste the key into Virvell

   Sign in to Virvell at virvell.ai/login. Go to Settings in the left sidebar. Under the Ashby ATS section, paste the API key and click Save. You should see the connection status change to Connected, with three assessment types listed: Virvell Pre-Screen, Virvell Reference Check, and Virvell Background Check.

   

   Virvell Settings showing the Ashby connection active with all three assessment types.

Sending an assessment to a candidate

1. 1

   Open a candidate's profile in Ashby

   Navigate to the candidate you want to screen. You'll see their Activities & Progress tab.

   

   A candidate profile in Ashby.

2. 2

   Click + New Activity

   In the Current Activities section, click + New Activity. Select Assessment from the dropdown.

   

   The New Activity menu showing the Assessment option.

3. 3

   Select a Virvell assessment and start it

   Choose the Virvell assessment type you want — Pre-Screen, Reference Check, or Background Check. Click Add Activity, then click Start Assessment. The assessment card will show in the candidate's activity timeline with status "Request Sent."

   

   The Virvell Pre-Screen assessment card with Start Assessment button.

Viewing results in Ashby

When the assessment completes, the activity status updates automatically in Ashby. Click the assessment card to expand it and view the result summary. Click the View Report link to open the full Virvell report in a new tab.

Each assessment type produces a different report:

• Pre-Screen: conversation summary, structured answers, and a structured findings summary.
• Reference Check: intelligence findings across all references, with a full structured report.
• Background Check: criminal history, employment verification, and identity verification status.

Canceling an assessment

To cancel an in-progress assessment, click the three-dot menu (…) on the assessment activity card and select Cancel Assessment. The status will update to Cancelled in both Ashby and Virvell. Cancelled assessments do not consume credits.

An in-progress assessment showing the Cancel Assessment option.

What each assessment does

Troubleshooting

Need help?