Enabling and using the candidate.fyi integration

Available for Roles Super Admin, Admin, Team Member, Limited Team Member
Can only be enabled by Super Admins
Permissions • Manage API credentials and manage integrations
Packages LeverTRM, LeverTRM for Enterprise

The candidate.fyi integration allows Lever talent acquisition teams to seamlessly communicate with candidates and keep them up-to-date with where they stand in the interview process. If you would like more information or help with this integration, please contact candidate.fyi.

Setting up the candidate.fyi integration


You must be a team or organization with admin rights in candidate.fyi to install this integration.

Creating the API key in Lever

  • Log in to your Lever account
  • Navigate to Settings > Integrations and API > API Credentials
  • Under the 'Lever API credentials' section, click the Generate New Key button

Generate new key button on Lever's API credentials page

  • Under 'Permissions', check off the following permissions
Click to reveal the full list of permissions that should be configured:
  • Read user
  • Read stage
  • Read requisition
  • Read posting
  • Read opportunity referral
  • Read requisition field
  • Read posting apply form
  • Read opportunity resume
  • Read opportunity panel
  • Read opportunity interview
  • Read opportunity file
  • Read opportunity application
  • Read opportunity
  • Read feedback template
  • Read candidate resume
  • Read candidate panel
  • Read candidate interview
  • Read candidate file
  • Read candidate application
  • Read contact
  • Read candidate referral
  • Read candidate
  • Read archive reason
  • List users
  • List tags
  • List sources
  • List requisitions
  • List opportunity panels
  • List Webhooks
  • List stages
  • List requisitions
  • List postings
  • List opportunity referrals
  • List opportunity offers
  • List opportunity interviews
  • List opportunity feedback
  • List opportunities
  • List candidates
  • List candidate referrals
  • List candidate offers
  • List candidate interviews
  • List candidate files
  • List candidate applications
  • List archive reasons
  • List opportunity applications
  • List candidate panels


  • Enter a Key name (e.g. "candidate.fyi")
  • Click Copy Key

For more on this topic, refer to our help article on generating API keys.

Sending your API Key to candidate.fyi

candidate.fyi will ask that you provide your candidate.fyi representative with a Lever API key. You can share this securely using https://share.doppler.com/. Enter your API key and send the link over to your candidate.fyi representative. Within an hour, your Lever account will be connected to candidate.fyi. 

Using the candidate.fyi integration

  • Navigate to app.candidate.fyi and sign into your candidate.fyi account
  • Navigate to 'Jobs' via the side menu and select the 'ATS' tab; here you should see all of your jobs pulled in from Lever
  • Choose which jobs you would like to activate and click Activate
  • Continue setting up the configuration for your job

For more information about using the candidate.fyi integration, please reach out to candidate.fyi. 

Jobs ATS page in candidate.fyi with Activate button outlined next to job listing

Disabling the candidate.fyi integration

  • In Lever, navigate to Settings > Integrations and API
  • Under the 'API Credentials' tab, locate the candidate.fyi API credentials
  • Click the trash can icon to disable the integration
Was this article helpful?
0 out of 0 found this helpful