Enabling and using the Vetty integration

Melody Tsukahara

November 26, 2024 16:52

Available for	Roles	Super Admin
	Permissions	• Manage API credentials and manage integrations
	Packages	LeverTRM, LeverTRM for Enterprise

Vetty provides a friction-free candidate-centric background screening solution at scale with a seamless integration into Lever. The integration between Lever and Vetty allows you to automate the initiation of background screening orders, streamline reviews, and hire through powerful automated workflows.

In this article

Enabling the Vetty integration
Disabling the Vetty

Enabling the Vetty integration

Step 1: Generate a signature token in Lever

Navigate to Settings > Integrations and API > Webhooks
Click + Add webhook under the 'Candidate Stage Change' toggle and copy the signature token

Candidate stage change webhook tile with arrow pointing signature token.

Step 2: Configure the integration in Vetty

First, contact your Vetty CSM to let them know you will be integrating Vetty with Lever; the Vetty team will have to enable the connection from their side
Open Vetty and navigate to the Partner tab of the Settings page
On the Lever card, click to reveal the fields beneath the 'Webhook' heading
Paste the signature token from Lever into the corresponding field (1)
Type your company name into the field next to the Lever ATS URL (2)
Click Integrate (3)

Copy the Lever ATS URL.

Same fields as previous image now populated, with arrow pointing to Lever ATS URL field.

Step 3: Activate the integration in Lever

Navigate back to the Webhooks tab in the Integrations and API section of your Lever Settings page and paste the Lever ATS URL into the field beneath the 'Candidate Stage Change' toggle (the same tile from which you first copied the Lever signature token).
Flip the 'Candidates Stage Change' toggle to the 'on' position; the toggle will turn blue to indicate that it has been activated.

Candidate Stage Change toggle in Lever with Lever ATS URL pasted into field beneath it.

Step 4: Authorize the integration in Vetty

Navigate back to the Lever card on the Partner tab of your Vetty Settings page and click to expand the 'LeverAPI' heading
Click the Connect button

Arrow pointing to connect button aligned to the right of the LeverAPI heading on the Lever card in Vetty Settings.

In the modal that appears, log into Lever and click Accept to authorize the integration

Disabling the Vetty integration

Navigate to Settings > Integrations and API > Authorized Apps
Locate the Vetty app and click Revoke Access