Pushing hired candidate information from Lever into an HRIS

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

Lever’s webhooks allow you to seamlessly move candidates that are hired in Lever into your HRIS, minimizing time spent on manual data entry. Lever even supports one-click integrations with a number of HRIS platforms. Read about these integrations in the following articles:

For all other HRIS systems, including Workday, we recommend our custom webhook solution.

Getting started with a custom integration

To get started you will first want to enable and configure the candidate hired webhook for your account in Lever.

  • Navigate to Settings > Integrations and API > Webhooks

Webhook page in Integration Settings with arrow pointing to Webhooks tab

  • Click to toggle on the 'Candidate Hired' webhook and enter a callback URL. You can even verify that Lever can successfully POST to the provided url by clicking the Verify button.

Now that the candidate hired webhook is enabled, Lever will POST to the provided callback URL every time a candidate is marked as hired.

Handling webhook requests

For HRIS integrations, we recommend building a web server to receive the webhook requests from Lever and transform the data into a format consumable by your HRIS system.

Here is an example of how you can build your custom integration:

  1. A candidate is marked as hired in Lever and Lever POSTs a webhook request to the URL configured in integrations settings.
  2. Your web server receives the request and verifies that the request came from Lever using the request signature. You can find more information on how Lever generates its request signature for webhooks in our developer documentation.
  3. Your web server uses the candidateIds from the request body to request additional data for the candidate from Lever’s Read API. For example, you can retrieve the candidate profile to get the current stage of the candidate or get the candidate’s profile forms to determine their start date. Note that a candidate’s profile forms can be customized in your account to capture any additional information your HRIS integration requires.
  4. Your web server formats the candidate data in a consumable format for your HRIS and sends the data into the system to create a new employee record.

To learn more about what candidate data you can request from Lever’s Read API, check out the full list of resources in our developer documentation.

Was this article helpful?
0 out of 0 found this helpful