Lever Hiring
Set up the Lever Hiring source connector to read recruiting data from the Lever API.
Prerequisites
- A Lever account
- One of these credentials:
- API key (recommended for most users): Create one in Lever under Settings > Integrations and API > API Credentials. Lever states that API keys support internal workflows and carry broad privileges. Store your key securely.
- OAuth client ID, client secret, and refresh token: Lever offers OAuth only to registered partner applications through its partner program. With Airbyte Cloud, you can use Airbyte-managed OAuth without creating your own app.
- Confirm whether your Lever account uses a Production or Sandbox environment. The connector calls
api.lever.cofor production andapi.sandbox.lever.cofor sandbox.
Set up the connector
- In the Airbyte UI, select Sources, then New source.
- Search for and select Lever Hiring.
- Enter a Source name.
- For Start Date, enter a UTC timestamp using
YYYY-MM-DDTHH:MM:SSZ, for example2021-03-01T00:00:00Z. The connector uses this value as theupdated_at_startrequest parameter when listing opportunities. It won’t replicate opportunities last updated before this date. It also won’t replicate their related applications, interviews, notes, offers or referrals. This setting doesn’t affect theusersstream. - For Environment, select Production or Sandbox. The default is Sandbox. Select Production when connecting to a regular Lever account.
- For Authentication Mechanism, choose one of these options:
- Authenticate via Lever (Api Key): Enter your Lever API key.
- Authenticate via Lever (OAuth): In Airbyte Cloud, use the OAuth button to sign in to Lever and grant access. In self-managed Airbyte, enter your registered Lever OAuth app’s Client ID, Client Secret and Refresh Token. The refresh token must have been issued with the
offline_accessscope.
- Select Set up source.
The connector verifies your credentials by requesting the users endpoint.
Supported sync modes
| Feature | Supported? |
|---|---|
| Full Refresh Sync | Yes |
| Incremental - Append Sync | Yes (opportunities only) |
| Namespaces | No |
Supported streams
| Stream | Lever endpoint | Sync modes | Notes |
|---|---|---|---|
| Opportunities | GET /opportunities | Full Refresh, Incremental | Incremental syncs use the updatedAt field as the cursor and request 30-day windows with updated_at_start and updated_at_end. |
| Users | GET /users | Full Refresh | Includes deactivated users (includeDeactivated=true). Not filtered by Start Date. |
| Applications | GET /opportunities/{id}/applications | Full Refresh | Fetched per opportunity. |
| Interviews | GET /opportunities/{id}/interviews | Full Refresh | Fetched per opportunity. |
| Notes | GET /opportunities/{id}/notes | Full Refresh | Fetched per opportunity. |
| Offers | GET /opportunities/{id}/offers | Full Refresh | Fetched per opportunity. |
| Referrals | GET /opportunities/{id}/referrals | Full Refresh | Fetched per opportunity. |
The applications, interviews, notes, offers and referrals streams first list opportunities. They use the same updated_at_start/updated_at_end windows as the opportunities stream, starting from your Start Date. They then request each opportunity’s child records. Records for opportunities outside that window aren’t synced. Each opportunity requires one request per child stream. These streams can therefore take a long time to sync for a large Lever account.
Lever’s updated_at_start filter matches any change to an opportunity. However, the connector’s updatedAt cursor only reflects changes to a specific set of opportunity fields. This difference can explain unexpected opportunities or missing changes in incremental syncs.
Limits and troubleshooting
Rate limits
Lever uses a token bucket to limit requests for each API key. The steady rate is 10 requests per second, with bursts up to 20 requests per second. There are no endpoint-specific limits. The connector retries requests that Lever rejects with 429 Too Many Requests. See Lever rate limits.
Incremental syncs repeat records
Versions before 0.4.42 used cursor granularity that didn’t match Lever’s millisecond timestamps. This could make incremental syncs of the opportunities stream repeatedly request the same window. Upgrade to 0.4.42 or later to resolve this.
IP allow list
If your Airbyte Cloud account restricts access to specific IPs, add the Airbyte Cloud IP addresses to your allow list.
Changelog
Expand to review
| Version | Date | Pull Request | Subject |
|---|---|---|---|
| 0.4.52 | 2026-11-10 | 91604 | Update dependencies |
| 0.4.51 | 2026-11-03 | 90634 | Update dependencies |
| 0.4.50 | 2026-10-27 | 89993 | Update dependencies |
| 0.4.49 | 2026-10-20 | 89302 | Update dependencies |
| 0.4.48 | 2026-10-13 | 88708 | Update dependencies |
| 0.4.47 | 2026-10-06 | 87919 | Update dependencies |
| 0.4.46 | 2026-09-29 | 87248 | Update dependencies |
| 0.4.45 | 2026-09-22 | 86666 | Update dependencies |
| 0.4.44 | 2026-09-15 | 86130 | Update dependencies |
| 0.4.43 | 2026-09-08 | 85552 | Update dependencies |
| 0.4.42 | 2026-09-03 | 80293 | Fix incremental cursor stuck by aligning cursor_granularity with millisecond datetime_format |
| 0.4.41 | 2026-08-18 | 84669 | Update dependencies |
| 0.4.40 | 2026-08-11 | 84028 | Update dependencies |
| 0.4.39 | 2026-08-04 | 83535 | Update dependencies |
| 0.4.38 | 2026-07-28 | 83011 | Update dependencies |
| 0.4.37 | 2026-07-21 | 82510 | Update dependencies |
| 0.4.36 | 2026-07-14 | 81920 | Update dependencies |
| 0.4.35 | 2026-06-30 | 81138 | Update dependencies |
| 0.4.34 | 2026-06-23 | 80552 | Update dependencies |
| 0.4.33 | 2026-06-16 | 79956 | Update dependencies |
| 0.4.32 | 2026-06-09 | 79384 | Update dependencies |
| 0.4.31 | 2026-06-02 | 78801 | Update dependencies |
| 0.4.30 | 2026-04-28 | 77295 | Update dependencies |
| 0.4.29 | 2026-04-21 | 76653 | Update dependencies |
| 0.4.28 | 2026-03-31 | 75032 | Update dependencies |
| 0.4.27 | 2026-02-24 | 73939 | Update dependencies |
| 0.4.26 | 2026-02-17 | 73554 | Update dependencies |
| 0.4.25 | 2026-02-10 | 73047 | Update dependencies |
| 0.4.24 | 2026-02-03 | 72762 | Update dependencies |
| 0.4.23 | 2026-01-20 | 72002 | Update dependencies |
| 0.4.22 | 2026-01-14 | 71449 | Update dependencies |
| 0.4.21 | 2025-12-18 | 70794 | Update dependencies |
| 0.4.20 | 2025-11-25 | 69501 | Update dependencies |
| 0.4.19 | 2025-10-29 | 68936 | Update dependencies |
| 0.4.18 | 2025-10-21 | 68331 | Update dependencies |
| 0.4.17 | 2025-10-14 | 68064 | Update dependencies |
| 0.4.16 | 2025-10-07 | 67526 | Update dependencies |
| 0.4.15 | 2025-09-30 | 66814 | Update dependencies |
| 0.4.14 | 2025-09-24 | 66648 | Update dependencies |
| 0.4.13 | 2025-09-09 | 66083 | Update dependencies |
| 0.4.12 | 2025-08-23 | 65324 | Update dependencies |
| 0.4.11 | 2025-08-09 | 64602 | Update dependencies |
| 0.4.10 | 2025-08-02 | 64302 | Update dependencies |
| 0.4.9 | 2025-07-26 | 63847 | Update dependencies |
| 0.4.8 | 2025-07-19 | 63519 | Update dependencies |
| 0.4.7 | 2025-07-12 | 63111 | Update dependencies |
| 0.4.6 | 2025-07-05 | 62598 | Update dependencies |
| 0.4.5 | 2025-06-28 | 62189 | Update dependencies |
| 0.4.4 | 2025-06-21 | 61808 | Update dependencies |
| 0.4.3 | 2025-06-14 | 48264 | Update dependencies |
| 0.4.2 | 2024-10-28 | 43750 | Update dependencies |
| 0.4.1 | 2024-08-16 | 44196 | Bump source-declarative-manifest version |
| 0.4.0 | 2024-08-15 | 44133 | Refactor connector to manifest-only format |
| 0.3.1 | 2024-06-04 | 39082 | [autopull] Upgrade base image to v1.2.1 |
| 0.3.0 | 2024-05-08 | 36262 | Migrate to Low Code |
| 0.2.0 | 2023-05-25 | 26564 | Migrate to advancedAuth |
| 0.1.3 | 2022-10-14 | 17996 | Add Basic Auth management |
| 0.1.2 | 2021-12-30 | 9214 | Update title and descriptions |
| 0.1.1 | 2021-12-16 | 7677 | OAuth Automated Authentication |
| 0.1.0 | 2021-09-22 | 6141 | Add Lever Hiring Source Connector |