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
- Log in to your Lever account.
- Go to Settings → Integrations and API → API Credentials.
- Click Create new API key (or a similar button).
- Name the key (for example, “Get on Board integration”).
- Select the required permissions: - Read job postings. - Create opportunities (candidates). - Read opportunities data.
- Copy the API key immediately and store it securely. You will not be able to see it again after closing the dialog.
- 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.