Skip to main content
Harly imports Lever pipeline opportunities into a selected Harly job. Lever is candidate-centric, so the importer reads opportunities rather than the legacy Candidates endpoint. This is a one-time migration, not a live synchronization.

​
Before you begin

You need a Lever API key with read access to Opportunities. Lever API keys can carry broad privileges, and access to confidential opportunities is granted when the key is created, so use a dedicated key with the smallest access your migration needs.

​
Create the Lever API key

1

Open Lever API settings

In Lever, open Settings → Integrations and API → API Credentials.
2

Create a read key

Create an API key and enable the read permission for Opportunities. Enable confidential-data access only if those opportunities must be migrated.
3

Run the Harly import

Open Candidates → Import candidates, choose Lever, select the destination job, paste the API key, and select Import Lever candidates.
Harly calls GET https://api.lever.co/v1/opportunities?limit=100 using Basic Auth, follows Lever’s offset pagination, and retries temporary rate-limit or server errors. The key is used once and never persisted by Harly.

​
What Harly imports

  • Name, email, phone, and location
  • Headline
  • LinkedIn, GitHub, and other website URLs
  • Opportunity tags
The importer reads at most 5,000 opportunities per run. Records without a first name, last name, or email are skipped and included in the summary.
Education, employment history, resumes, attachments, feedback, interviews, and application answers are not downloaded by this importer. Lever’s opportunity data is currently imported as the profile fields listed above.

​
Troubleshooting

See Lever’s API overview and authentication and opportunities reference.