Grayscale

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: 

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

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

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)

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)

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

Go to <a href="https://hire.lever.co/settings/integrations" rel="nofollow noopener noreferrer" target="_blank">Lever’s integrations settings page.</a>

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.

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

1. Go to <a href="https://hire.lever.co/settings/integrations" rel="nofollow noopener noreferrer" target="_blank">Lever’s integrations settings page.</a>
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 a 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 want to enable the following permissions:

- List Users
- List Opportunities
- List Stages
- List Postings
- List Opportunity Interviews
- List Archive Reasons
- Read User
- Read Opportunity
- Read Opportunity Application
- Read Opportunity Note
- Read Opportunity Interviews
- Read StageRead Posting
- Read Archive Reasons
- Create Opportunity Note
- Confidential Data Access 
- Create Opportunity Interview 
- Delete Opportunity Interview 
- Update Opportunity Interview 

Copy the newly generated API key from Lever head over to your Grayscale Settings &gt; ATS Integration &gt; Lever

Click Edit and paste Lever API Key

Scroll to the bottom and click Save ​

1. Copy the newly generated API key from Lever head over to your Grayscale Settings &gt; ATS Integration &gt; 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 

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

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

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

Paste each unique Lever Webhook in Grayscale and save!

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. 

Activating Your Lever Integration

STEP 1: Generate an API Key in Lever

STEP 2: Add API Key in Grayscale

Step 3: Copy the Webhook URL In Grayscale

Step 4: Create 8 total Webhooks in Lever

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