This guide assumes you already have a Kombo account. If that’s not the case, visit our website to learn more and get access.

Set the integration up

  1. Log in to the Kombo Dashboard
  2. Go to the “Integrations” page
  3. Click “New integration”
  1. Select “Create the integration yourself”:
  1. Enter the metadata for the integration Select the ATS of the category

Enter the name and email of the organization that this Lever instance belongs to (these values are not important and only serve as future reference points)

Optional: configure which data points and write actions should be made available for this integration. If you leave this turned off, your default scopes will be used

Scroll to the very bottom and click continue

  1. Type in “Lever” in the search bar and click on the logo that just appeared
  2. Check the permissions that are configured and click “Continue” if you’re happy with them
  3. On the next page click “Continue” to enter the OAuth flow
  4. Log into your Lever account on the next page

Congratulations! You now have connected your Lever ATS and should see it in your integrations overview

Configure the Integration

If you need to configure anything about your integration, find it on the integrations overview (As shown in step 9 of “Set up the Integration”) and click on it to get to the integrations details page

Changing the scope configuration

Once you are on the integrations details page, scroll down to the Scope config block

Triggering a custom sync

By default, data is synced every three hours. You can trigger a sync earlier than that either by hitting the /force-sync api endpoint (documented here) or by clicking the “Sync now” button in the integrations overview

Updating the integration credentials

If the user that authenticated the integration changed their lever password or some other authentication problems occured, you can relink the integration without having to create a new one.

Go to the integration details page and click on the “Create update link” button.

The generated link can be used to re-authenticate the existing Lever integration