How to get a Lever v1 API key (Data API key)

How to get a Lever v1 API key (Data API key)

To enable full integration of your Lever ATS with Get on Board, including automatic candidate exports, you need a Lever Data API v1 key.

Steps to get a v1 API key

  1. Log in to your Lever account.
  2. Go to SettingsIntegrations and APIAPI Credentials.
  3. Click Create new API key (or a similar button).
  4. Name the key (for example, “Get on Board integration”).
  5. Select the required permissions: - Read job postings. - Create opportunities (candidates). - Read opportunities data.
  6. Copy the API key immediately and store it securely. You will not be able to see it again after closing the dialog.
  7. In Get on Board, open the Lever integration settings, enter your Lever site name, paste the API key, and test the connection.

Important notes

  • API version: Keys created in Lever are v1 (Data API) by default.
  • Authentication: Lever API keys use Basic Auth (API key as username, blank password).
  • Multiple keys: You can keep multiple keys active at once.
  • Security: Treat API keys as sensitive credentials.

How to tell if you have the right key

  • v1 (Data API): Full integration support, including job imports and candidate exports.
  • v0 (Postings API): Limited support. Job imports work, but candidate exports fail.

If you currently have a v0 key, Get on Board will show a warning during setup. Job imports will still work, but candidates who apply through Get on Board will not be exported to Lever.

Related articles

More from Integrations and developer tools