Skip to main content
All CollectionsGetting StartedRecruiting IntegrationsLever ATS
How to Activate a Lever Integration
How to Activate a Lever Integration

A step-by-step guide for setting up your Lever integration

Sam Abello avatar
Written by Sam Abello
Updated over 3 weeks ago

Grayscale’s Lever integration makes it easy to text and engage with candidates from directly within Lever. A few important notes before we get started:

  1. You must be a Super Admin in Lever to enable this integration

  2. The integration uses webhooks, so you'll want to allow a few days for your data to sync completely

  3. The conversation transcript import is on a 1-hour delay. We import the transcript as a Note 1 hour after the last message was sent/received (this is to prevent your Note section from getting cluttered with a note per text message)

Activating Your Lever Integration

Let's get started with the setup! Here’s how to enable the integration in a matter of minutes:

STEP 1: Generate an API Key in Lever

  1. Go to Lever’s integrations settings page.

  2. Look for the category Communication and click the toggle next to Grayscale’s logo

    Grayscale tile on Integrations and API page with arrow pointing to Generate New Key button.

  3. Click 'Generate New Key' You'll be able to see exactly which actions the integration with Grayscale will authorize.

NOTE: For enterprise Lever customers creating a custom API key ONLY:

If you are creating a custom API key in Lever, you'll need to enable the following permissions:

Read Endpoints

  • Find all users

  • Find all opportunities

  • Find all stages

  • Find all postings

  • Find all opportunity interviews

  • Find all archive reasons

  • Find a user

  • Find an opportunity

  • Find an opportunity application

  • Find an opportunity note

  • Find an opportunity interview

  • Find a stage

  • Find a posting

  • Find an archive reason

Write Endpoints

  • Create an opportunity note

  • Create an opportunity interview

  • Delete an opportunity interview

  • Update an opportunity interview

Under Confidential data access, toggle on "Allow access to confidential data" (optional).

STEP 2: Add API Key in Grayscale

  1. Copy the newly generated API key from Lever head over to your Grayscale Settings > ATS Integration > Lever

  2. Click Edit and paste Lever API Key

  3. Scroll to the bottom and click Save
    ​

Step 3: Copy the Webhook URL In Grayscale

Step 4: Create 8 total Webhooks in Lever

  1. Navigate back to Lever and go to Settings. Click the Webhooks tab at the top of the Integrations and API page

  2. Click + Add webhook and paste the Grayscale URL into the URL field for all 8 sections:

    • Application Created

    • Candidate Stage Change

    • Candidate Archive State Change

    • Candidate Hired

    • Candidate Deleted

    • Interview Created

    • Interview Updated

    • Interview Deleted

Application Created tile on webhooks tab in Lever with arrow pointing to blank field for Grayscale webhook URL.

Step 5: Copy and Paste each unique Lever Webhook signature token into your Grayscale ATS Integration Settings

  1. Copy each unique Lever Webhook

  2. Paste each unique Lever Webhook in Grayscale and save!

That’s it! The integration uses webhooks, so you'll want to allow a few days for your data to sync completely.

Questions? Chat with us below!
​

Related Articles
How to Activate a Greenhouse Integration
Setting up Automated Interview Reminders & Follow-ups
I'm on Lever – do I need to do anything to enable automated Interview Reminders?
2. 1-1 Texting in Lever (training video)
How to automate the opt-in process in Lever
Did this answer your question?