How to Get a Lever v1 API Key (Data API Key)

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


Steps to Get a v1 API Key:

  1. Log in to your Lever account
    • Go to Settings → Integrations and API
    • Click on the API Credentials tab
  2. Create a new API key
    • Click on "Create new API key" or similar button
    • Give it a descriptive name (e.g., "Get on Board Integration")
    • Select the required permissions:
      • Read job postings
      • Create opportunities (candidates)
      • Read opportunities data
  3. Copy and Save Your API Key
    • Important: Copy the API key immediately and store it securely
    • You won't be able to see it again after closing the dialog
    • Keep your API key confidential - it carries many privileges
  4. Configure Get on Board Integration
    • Go to Get on Board's Lever integration settings
    • Enter your Lever site name
    • Paste the API key you just created
    • Test the connection to verify it works

Important Notes:

  • API Version: All API keys created from the Lever dashboard are v1 (Data API) keys by default
  • Authentication: Lever API keys use Basic Auth (API key as username, password left blank)
  • Multiple Keys: You can have multiple API keys active at once if needed
  • Security: Keep your API keys secret and confidential


How to Tell if You Have the Right Key:

  • v1 (Data API): Full integration support - job imports AND candidate exports ✓
  • v0 (Postings API): Limited support - only job imports, candidate exports will fail ✗

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

Latest on Help & Support