Help  /  Integrations

Virvell × Lever Integration

Setup, stage-triggered screening, and viewing results in Lever.

Virvell adds three AI-powered screening services to Lever — pre-screen interviews, voice reference checks, and background verification — that run automatically when candidates move to mapped stages in your pipeline. Results write back to Lever as structured notes on the opportunity timeline. 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.
  • Super Admin access to your Lever workspace (you'll need to configure a webhook in Lever's admin settings).
  • Estimated setup time: under 10 minutes.

Setting up the integration

  1. 1

    Connect Lever in Virvell

    Sign in to Virvell at virvell.ai/login. Go to Settings in the left sidebar. Under the Lever ATS section, click Connect with Lever. You'll be redirected to Lever to approve the connection. Lever will show the permissions Virvell is requesting — review and click Accept. You'll be returned to Virvell Settings with a green Connected status badge.

    Virvell Settings showing the Lever connection active with two-step setup cards visible.

    Virvell Settings showing the Lever connection active with two-step setup cards visible.

  2. 2

    Copy the webhook URL from Virvell

    Below the Connected badge, you'll see Step 1. Paste this URL into Lever's admin with a webhook URL and a Copy button. Click Copy.

    The Step 1 card in Virvell with the webhook URL and Copy button.

    The Step 1 card in Virvell with the webhook URL and Copy button.

  3. 3

    Add the webhook in Lever's admin

    In a new tab, sign in to Lever and navigate to Settings → Integrations and API → Webhooks. Find the Candidate stage change row and click Add webhook. Paste the URL you copied from Virvell into the URL field and click Save.

    The Webhooks page in Lever's admin with the Candidate stage change row.

    The Webhooks page in Lever's admin with the Candidate stage change row.

  4. 4

    Copy the signing token from Lever

    After saving the webhook, Lever will display a signing token. Copy this token — you'll paste it into Virvell next.

    The signing token displayed by Lever after saving the webhook URL.

    The signing token displayed by Lever after saving the webhook URL.

  5. 5

    Paste the signing token into Virvell

    Switch back to Virvell Settings. In the Step 2. Paste the signing token from Lever card, paste the signing token into the field and click Verify.

    The Step 2 card in Virvell with the signing token field and Verify button.

    The Step 2 card in Virvell with the signing token field and Verify button.

    The setup will show Waiting for Lever to send the first event. This usually completes within a few seconds, after Lever fires its first webhook delivery to confirm the connection. If the wait runs longer than a minute, move any candidate between stages in Lever to trigger a webhook. Once Virvell receives a verified delivery, the status flips to Webhook verified.

    Virvell showing the verified webhook state.

    Virvell showing the verified webhook state.

Mapping stages to screening actions

  1. 1

    Browse stages from a posting

    In the Browse stages from a posting dropdown, select any active posting in your Lever account. The pipeline stages for that posting will appear as clickable chips.

    Stage Mappings showing a posting selected and stage chips visible.

    Stage Mappings showing a posting selected and stage chips visible.

  2. 2

    Add a stage trigger

    Click + Add Stage Trigger, then click any stage chip to populate the stage name field. Choose a screening action from the dropdown:

    • Pre-Screen Interview — launches an AI voice screening call to the candidate
    • Reference Check — initiates voice AI outreach to references on file
    • Background Check — runs Certn-powered verification

    You can add multiple triggers — for example, Phone screen → Pre-Screen Interview, then Reference check stage → Reference Check.

  3. 3

    Optionally enable auto-advance

    Check Auto-advance candidates to have Virvell automatically move candidates to their next Lever stage when the screening action completes. Leave unchecked if you prefer to manually review results before advancing.

  4. 4

    Save your mappings

    Click Save Stage Mappings. The mappings take effect immediately for any future stage changes in Lever.

Triggering screening from Lever

Once configured, screening is fully automatic.

When a recruiter on your team moves a candidate to a mapped stage in Lever, Virvell receives the stage change event, identifies the candidate, and launches the configured screening action. No clicks in Virvell are needed.

The candidate will be contacted directly:

  • Pre-screen — voice call to the candidate's phone number on file
  • Reference check — voice calls to the references on the candidate's profile
  • Background check — Certn outreach via email for consent and identity verification

Viewing results in Lever

When a screening completes, Virvell writes a structured note to the candidate's opportunity timeline in Lever. Open the candidate's profile in Lever and scroll to the activity feed to see the note.

A completed Virvell pre-screen note on a candidate opportunity in Lever.

A completed Virvell pre-screen note on a candidate opportunity in Lever.

The note includes:

  • Candidate name, position, date, and screening duration
  • Summary of the screening
  • Key strengths and areas of concern (observational, never decision-recommending)
  • Link to the full report in your Virvell dashboard

To open the full structured report — including the conversation transcript, structured findings, and any Evidence Intelligence — sign in to Virvell and navigate to the candidate's record.

Troubleshooting

Verification doesn't complete after I paste the signing token.

Lever fires its first webhook delivery automatically when you save the webhook URL, but timing can vary. If verification doesn't land within a minute, move any candidate between stages in Lever to trigger a webhook delivery. Once Virvell receives a verified delivery, the status flips to Webhook verified.

My stage triggers aren't firing.

Verify three things: (1) the connection is Webhook verified in Virvell Settings, (2) the stage name in your trigger configuration matches the stage in Lever exactly (case-insensitive), (3) the candidate has a phone number in international format (e.g., +14165551234) for pre-screens, or references with phone numbers on file for reference checks.

The signing token in Lever changed.

If you regenerate or rotate the signing token in Lever's admin, paste the new token into Virvell's Step 2 field and click Verify again. Virvell will re-verify with the next webhook delivery.

Notes in Lever look like text without formatting.

Lever's notes API displays content as plain text. Virvell formats notes with structural cues (capitalized headers, bullet points, separators) so they remain readable in the Lever activity feed.

Can I disconnect the integration?

Yes. In Virvell Settings, click Disconnect under the Lever ATS section. Virvell will stop receiving stage change events. The webhook in your Lever admin remains in place — if you reconnect later, the same webhook URL still works. To remove the webhook entirely, delete it from Lever's admin webhook settings.

How are screenings billed?

Each Virvell screening uses one credit from your plan. Background checks have additional Certn provider costs billed separately. See virvell.ai/pricing for details.

Need help?

Email us at support@virvell.ai — we typically respond within a few hours on business days.

Check platform status: stats.uptimerobot.com/5bri4fMkbR