Integrating Lever with the Lever Requisitions app
This section covers the process for setting up your API to begin syncs between Lever and the ChartHop Lever Requisitions App.
To get started, you will need to obtain API access from Lever. You'll need to obtain an API key by following the steps below.
Before creating your Lever API Key, be sure to enable "confidential access" in Lever.
- Open Lever.
- Navigate to Integrations.
- Select API Credentials.
- Click Generate new key.
- Enter key name: ChartHop.
- Enable all read permissions.
- Enable the following write permissions.
- Create requisitions
- Delete requisitions
- Update posting
- Update requisition fields
- Copy the provided API Key.
Once you've received the necessary information from Lever, do not share this information with anyone outside of your organization, as it enables direct access to your data within Lever.
In order to use the API credentials you gathered above, you will need to install the Lever Requisitions app in ChartHop. To install, follow the steps below.
- Navigate to Apps and Integrations in ChartHop.
- Find Lever in the list of available apps.
- Select Install on the far right-hand side of the table.
Recommended settings for the ChartHop Lever Requisitions App include:
- Run Daily
- Sync on Change
In order for ChartHop to access your Lever data, you'll need to enter the Lever API credentials you obtained above. In addition, there are a number of other configuration settings available to you.
Lever sync options are listed below:
Lever API key
The API key generated in Lever.
With this option enabled, Lever will run automatically every day.
Resync on daily run
With this option enabled, ChartHop will update Lever with new changes on the daily run.
Sync on change
With this option enabled, changes to job statuses will be automatically pushed to Lever when they are made.
With this option enabled, the sync direction is reversed - Lever becomes the system of record, and ChartHop is updated with open roles from Lever.
When enabled, reconciles Lever role and field data with ChartHop. This option cannot be used with Reverse Sync enabled. Learn more.
Remote location as default
With this option enabled, newly synced records that are not assigned a location will be assigned the value Remote Location.
For which options to choose when configuring your settings, we recommended the options listed in the image below:
On the right are the required settings for the ChartHop Lever Requisitions App which include:
- Run Daily (minimum required setting)
- Sync on Change (minimum required setting)
On the left, you'll find the corresponding Status Mappings between ChartHop and Lever when creating new roles.
Next, set up the Candidate Hired webhook in Lever so that ChartHop can capture new hires from Lever:
- Open ChartHop.
- Navigate to the Lever Requisitions app page.
- Copy the URL provided in the Web Hook Setup section, below the synced fields table.
- Navigate to Lever.
- Open Integrations, then Webhook.
- Select Candidate Hire.
- Paste the webhook.
- Select Verify Connection.
With the webhook enabled, accepted offers in Lever will be pulled into ChartHop, alongside the new hire's start date, and contact information.