Setting up the Lever integration

This section covers the process for setting up your Lever Requisitions integration app to begin migrating requisition data between Lever and ChartHop.

Setting up the Lever Requisitions integration app requires the following steps:

1. Create a Lever API key
2. Install the Lever integration app
3. Set up the API connection
4. Set up the flow of requisition data
5. Set up the flow of new hire data

In order for ChartHop to access your organization's Lever recruiting data, you need to create a Lever API key that you can use with ChartHop. You can work with your Lever Requisitions administrator if you have questions. 

To create your API key, follow the steps outlined in the Generating API Credentials in Lever. Use the instructions in the Lever documentation to create your API key and use the following values when doing so.

After you name your key and enable all of its read permissions, you need to configure the key’s write permissions.

Enable the following write permissions:

• Create requisitions
• Delete requisitions
• Update posting
• Update requisition fields

Once you've created your API key in Lever, you can install the Lever integration app in ChartHop.

 To install the Lever Requisitions integration app:

1. Navigate to Apps from the settings (gear) menu in the left side bar.
2. Select the All Apps tab.
3. Scroll the list down to the Lever Requisitions app.
4. Select Install.
5. Select Install from the app install page.

In order to allow ChartHop to access your Lever data, enter your Lever API credential in the Lever Requisitions API Key field in the Settings section of the app. Then, paste your previously created Lever API Key in the Lever Requisitions API Key field.

Once you establish your API connection, you can configure the type of requisition data flow that the integration runs. 

When setting up your integration, you can choose the primary source of truth when referencing new requisition data. Selecting ChartHop results in an outbound job data flow where ChartHop is the source of truth, whereas, selecting Remote System (Lever Requisitions) results in an inbound job data flow where the ATS is the source of truth.

To select your Lever Requisitions integration’s source of truth:

1. Navigate to Apps from the settings (gear) menu in the left side bar.
2. Select the All Apps tab.
3. Scroll the list down to the Lever Requisitions app.
4. Select the Lever Requisitions app.
5. From the ChartHop Lever Requisitions app settings page, scroll down to the Source of Truth section.
6. Select one of the two options:
   1. ChartHop - ChartHop is the source of truth and the integration is configured to run an outbound job data flow.
   2. Remote System (Lever Requisitions) -  Lever is the source of truth and the integration is configured to run an inbound job data flow.

You can configure the Lever Requisitions integration app to handle two types of data migrations (job data flows) between ChartHop and Lever Requisitions. Depending on the type of job data flow you choose, you may enable specific configurations that may either be required or optional and yet, recommended.

These are the required and recommended configurations for each job data flow:

To and change the configuration options for your Lever Requisitions integration:

1. Navigate to Apps from the settings (gear) menu in the left side bar.
2. Select the All Apps tab.
3. Scroll the list down to the Lever Requisitions app.
4. Select the Lever Requisitions app.
5. From the ChartHop Lever Requisitions app settings page, scroll down to the Other Options section.
6. Select from the following configuration options described in the table below.

After you select your integration’s source of truth, you can select additional options to further customize and configure it:

You can use the new hire webhook job data flow to automatically bring new hires from Lever to ChartHop when the candidate is marked as “Hired” in Lever, along with their relevant personal information, such as address, phone number, and email.

New hire webhooks will not be processed if the person being hired already exists in ChartHop, even if they aren’t actively in a role. As a result, the integration cannot support:

• Internal transfers
• Re-hires

Only the first new hire webhook for a ChartHop job is supported. For example, if they you update an offer packet and re-hire the candidate in Lever, the updated information will not be processed in ChartHop unless the new hire in ChartHop is removed first.

A new hire webhook will not be processed if the job does not exist in ChartHop.

To configure the new hire webhook job data flow, follow the steps below.

In ChartHop:

1. Navigate to Apps from the settings (gear) menu in the left side bar.
2. Select the All Apps tab.
3. Scroll the list down to the Lever Requisitions app.
4. Select the Lever Requisitions  app.
5. From the ChartHop Lever Requisitions  app settings page, copy the secret key value under Webhook Setup.

In Lever:

1. Navigate to Integrations and API under Settings.
2. Select Webhooks.
3. Enable Candidate Hire to on.
4. Add the webhook.
5. Select Verify Connection.

With the webhook enabled, accepted offers in Lever are pulled into ChartHop, alongside the new hire's start date, and contact information.