Integration set-up guide for Lever

Updated:


September 27, 2023

To connect your customers' Lever accounts to your product through Unified.to, activate Lever in your Unified.to workspace, choose how customers authorize (Lever OAuth 2 with your own Lever client ID and secret, or a Lever API key each customer creates), embed the Authorization component, and save the connection ID each customer creates. As of 21 October 2026, Lever issues OAuth client IDs and secrets only to approved Lever partners, so teams without a partnership connect customers with Lever API keys. Your code then reads and writes Lever candidates, applications, jobs, notes and users through Unified.to's ATS and HR & Directory APIs.

This guide covers each step, from activation to your first API call, and what Unified.to's Lever integration supports.

Which authorization method should you use for Lever?

Use Lever OAuth 2 if you're an approved Lever partner, and Lever API keys if you're not. As of 21 October 2026, Lever says "As of 2020, all Lever integrations are authenticated using OAuth" and doesn't provide API keys for partner development (Lever OAuth documentation). Customers can still create API keys in their own Lever account. Unified.to's Lever integration offers both methods (Lever integration page).

Lever OAuth 2Lever API key
Who issues the credentialLever's team, after Lever approves you as a partnerA Super Admin in your customer's Lever account
What you add in Unified.toYour Lever client ID and secret, when you activate LeverNothing; each customer enters their key in the Authorization component
Who approves access in LeverA Lever Super Admin, for the whole Lever organizationThe Super Admin who creates the key and chooses its permissions
Lever plan requirement (as of 21 October 2026)Available to all Lever customersCustomer needs Lever's Data API feature
As of 20 September 2026, Unified.to doesn't supply shared Lever OAuth credentials, so Lever OAuth 2 connections need your own Lever client ID and secret, which means your own Lever partnership. Plan and access rules are from Lever's partner process page, as of 21 October 2026.

What do you need before you start?

You need a Unified.to account and one of the two Lever credentials above.

  • Unified.to account: sign up at app.unified.to. Grow and Pro start with a 30-day free trial.
  • For Lever OAuth 2: Lever partner approval and the client ID and secret Lever sends you (step 2).
  • For Lever API keys: customers whose Lever plan includes the Data API feature, with a Super Admin who can create the key.

Start a 30-day free trial

1. How do you activate Lever in Unified.to?

Open Integrations in Unified.to, search for Lever or filter by the ATS category, open the Lever card and select Activate. The integrations you activate are the ones your customers see in the Authorization component.

Screenshot_2026-10-21_at_9.53.58_AM.png

2. How do you get Lever OAuth 2 credentials?

Lever OAuth 2 credentials come only through Lever's partner program: as of 21 October 2026, "Someone on the Lever team will create your OAuth app and send over your ClientID and Secret" (Lever partner process). Unified.to has no shared Lever OAuth app, so this step is required for Lever OAuth 2. Skip it only if your customers will connect with API keys.

  1. Tell Lever you want to build an integration, using Lever's partnership interest form. Lever's partnerships team reviews each request.
  2. Once Lever approves you, it provides a Lever sandbox account. Email is turned off in the sandbox, so invited users sign in through the login link.
  3. Register your sandbox OAuth app (fields below). Lever's team creates it and sends the client ID and secret.
  4. Build and test against the sandbox, then send Lever its four packages: a help centre article about your integration, two sandbox logins for Lever (sadmin@levertest.com and integration-support@lever.co), listing information and technical support details.
  5. After a QA run-through, where you share your screen and walk through the full connection journey, Lever provides production OAuth credentials.

What does Lever ask for when you register the app?

Lever asks for an integration name, a description of 20 to 140 characters, a callback URI, a link to a square logo (150 × 150 px recommended; not a Google Drive or download link) and the scopes you need (Lever OAuth documentation, as of 21 October 2026). Lever's scope rules:

  • Most use cases need 5 to 8 scopes, and the maximum is 20.
  • A write:admin scope includes its read:admin scope, so register only the write scope when you need both.
  • Include offline_access. Without it, Lever issues no refresh token.

As of 20 September 2026, Unified.to's Lever integration requests offline_access plus Lever scopes for opportunities, contact, resumes, postings, users, interviews, stages, files, notes and webhooks, at read or write level depending on the Unified.to objects you use (Lever OAuth app skill). Register those resources with Lever, using the write:admin form for any object you create, update or remove: that's 11 scopes, within Lever's limit of 20. Unified.to doesn't request Lever's confidential:access:admin scope. See Understanding scopes.

Which callback URI do you give Lever?

Give Lever the Unified.to callback URI for your workspace's region. Each workspace has one region: US on every plan, EU or AU on Pro and Scale.

Unified.to workspace regionCallback URI
US (every plan)https://api.unified.to/oauth/code
EU (Pro and Scale)https://api-eu.unified.to/oauth/code
AU (Pro and Scale)https://api-au.unified.to/oauth/code
Copy the URI exactly: a trailing slash, the wrong subdomain or http instead of https makes the connection fail. As of 21 October 2026, Lever requires the callback you use to match one registered with your app, and callbacks can't differ per customer. Lever's OAuth page says you register with one callback and request more through Lever support, and its FAQ says an app can have several, so list every region you need when you register. Lever's sandbox and production apps are separate, each with its own client ID, secret and callbacks.

3. Where do you enter the Lever client ID and secret?

On the Lever card in Unified.to, select Your OAuth 2 credentials, enter the Lever client ID and secret, and select Activate. To test against your Lever sandbox, select Sandbox on the card and enter the sandbox app's client ID and secret; Lever's sandbox and production credentials aren't interchangeable.

Screenshot_2026-10-21_at_9.54.54_AM.png

Lever's sandbox is a real Lever account for partners. Unified.to's own Sandbox (synthetic data) environment is different: it returns synthetic data and accepts any value as credentials (Sandbox).

When a customer connects, a Lever Super Admin approves your app for their whole Lever organization (Lever, as of 21 October 2026). Unified.to keeps no customer records at rest; connection credentials and operational metadata are encrypted at rest.

How do your customers create a Lever API key?

A Super Admin in your customer's Lever account creates the key under Settings > Integrations and API > API Credentials, then enters it when they choose Lever in your Authorization component (Lever API documentation and developer FAQ, as of 21 October 2026).

  1. Select Generate New Key and name the key after your product.
  2. Under Permissions, choose Select all, as shown in How to get your Lever API key. Lever checks every call against the key's permissions, so a key missing one fails on that endpoint.
  3. If the customer wants confidential postings and opportunities included, grant confidential access now. Lever allows it only when the key is created.
  4. Copy the key and paste it into your Authorization component.

Lever API keys "carry many privileges, so keep them secret", and a Lever account can have several active keys, so each product can have its own. Step-by-step screenshots: How to get your Lever API key.

What if your customer's Lever account is hosted in the EU?

Lever hosts some accounts in the EU, at hire.eu.lever.co instead of hire.lever.co. EU-hosted accounts use separate Lever servers, so the customer needs to choose the EU environment when they connect Lever in your Authorization component.

  • The customer creates their API key at hire.eu.lever.co, under Settings > Integrations and API > API Credentials, following the same steps above.
  • EU-hosted Lever accounts currently connect with API keys only. Lever OAuth 2 isn't available for EU accounts yet.
  • The EU environment refers to where the customer's Lever account is hosted. It's separate from your Unified.to workspace region.

4. How do you add Lever to your app?

Add Unified.to's Authorization component to your product: your customers pick Lever, authorize, and return to your app with a connection ID.

  1. Copy your workspace ID from Settings > API Keys in Unified.to. You can create several environments in one workspace for testing, staging and production; see Set environments for your Unified.to workspace.
  2. Open app.unified.to/embed, copy the snippet and replace YOUR_WORKSPACE_ID with your workspace ID. The preview shows what your customers see. Components are also available for React, Angular, Vue and Svelte (embedded components).
  3. To build your own UI instead, call GET /unified/integration/workspace/{workspace_id}, which returns all activated integrations in a workspace, and show those integrations in your app.
  4. After a customer authorizes, Unified.to returns them to your app with the connection ID in the URL (for example ?id={connection_id}). Store it with that customer's record (associate a connection ID with your end user).

5. How do you make your first Lever API call?

Call Unified.to's ATS endpoints with the customer's connection ID, for example GET /ats/{connection_id}/candidate to list Lever candidates. The same endpoints work for every ATS integration, so Lever calls differ from other ATS calls only by connection ID.

SDKs are available for TypeScript, Python, PHP, Java, Go, C# and Ruby (SDKs). To see the data model before a customer connects, add env=Sandbox to your API calls for synthetic data (Mock API server).

What can you do with a Lever connection?

As of 19 October 2026, Unified.to's Lever integration reads nine objects; it creates and updates candidates, applications, jobs, notes and users, adds documents, and removes candidates, documents, notes and interviews. It doesn't create or update interviews. Unified.to's candidate maps to Lever's opportunity, the object Lever has recommended since it deprecated its /candidates endpoints in 2020 (Lever API documentation, as of 21 October 2026). A Lever contact can have more than one opportunity, so a person with two Lever candidacies appears as two Unified.to candidates. Each Lever opportunity carries at most one application.

Unified.to objectLever objectMethodsChange events
ATS candidateOpportunityList, Get, Create, Update, RemoveCreated: virtual. Updated: native and virtual. Deleted: native
ATS applicationOpportunity posting stageList, Get, Create, UpdateCreated: native and virtual. Updated: virtual
ATS jobPostingList, Get, Create, UpdateCreated, updated: virtual
ATS interviewOpportunity interviewList, Get, RemoveCreated, updated: native and virtual. Deleted: native
ATS documentOpportunity fileList, Get, Create, RemoveCreated, updated: virtual
ATS activityOpportunity noteList, Get, Create, Update, RemoveNone
ATS scorecardOpportunity feedbackList, GetCreated, updated: virtual
ATS application statusStageListNone
HR & Directory employeeUserList, Get, Create, UpdateCreated, updated: virtual
PassthroughAny Lever API endpointGET, POST, PUT, DELETENone
Lever is one of 186 ATS integrations on Unified.to. Field-level detail is on the Lever integration page and in the ATS API overview.

How do Lever changes reach your app?

Unified.to delivers Lever changes to your webhook URL in two ways. Native webhooks forward the events Lever sends: candidate updates and deletions, new applications, and interview changes. Virtual webhooks detect changes at an interval you set, as often as every minute on paid plans, and a check that finds nothing isn't billed. Every other Lever object with change events in the table above uses virtual webhooks.

On Lever API-key connections, native webhooks need the customer's Lever plan to include Lever's Webhook feature. If Lever refuses the subscription, Unified.to marks the native webhook unhealthy and doesn't switch to virtual checks, so a webhook can be created and still receive no events. For API-key connections, check the webhook's health after you create it, or create a virtual webhook for candidate updates. On Lever OAuth 2 connections, include Lever's webhooks:read:admin and webhooks:write:admin scopes.

As of 21 October 2026, Lever labels its interview webhook events Beta (Lever API documentation). See Understanding virtual webhooks.

Which Lever limits should you plan for?

As of 21 October 2026, Lever's API documentation sets these limits:

  • Rate limit: 10 requests per second per API key, with bursts up to 20 when Lever allows. Lever says these defaults aren't guaranteed and recommends exponential backoff.
  • OAuth tokens: on Lever OAuth 2 connections, access tokens expire after one hour, and refresh tokens expire after one year or after 90 days without use. API-key connections use basic auth and have no tokens to expire. Unified.to refreshes OAuth tokens on a schedule, including on connections with no recent calls, and each refresh returns a new Lever refresh token, so an idle connection doesn't reach Lever's 90-day inactivity limit. If Lever rejects a connection's credentials, Unified.to marks the connection unhealthy and sends a CONNECTION_UNHEALTHY event, so you can ask the customer to re-authorize (troubleshoot unhealthy connections).
  • Confidential records: Lever returns confidential postings and opportunities only to credentials granted confidential access. Unified.to doesn't request Lever's confidential:access:admin scope (as of 20 September 2026), so Lever OAuth 2 connections don't return confidential records. On an API key, a Super Admin can grant confidential access only when creating the key.

Where can you get help?

Email hello@unified.to or chat with the team on Discord.

Keep learning:

Share
All guidesATS APIsAccounting Account Type Hierarchy in UnifiedAdvertising Report Metrics by IntegrationAmazon S3: Required IAM PermissionsATS to Vector DB: How to Power Talent Intelligence with Real-Time DataBuilding AI applications with Unified and LangbaseConcur & Concur (Company) — Connection GuideConfigure Greenhouse Native Candidate WebhooksConfigure Salesforce Meetings and Notes for UnifiedConnect Amazon Seller Central to Unified.toConnecting BambooHR via OAuth 2Connecting Google Workspace Integrations with a Service AccountCorrect WelcomeKit Scopes for Jungle IntegrationCreating Ads using the Unified Ads APICreating Walmart Items via UnifiedEnd-Users, Integrations, and ConnectionsEnriching Unified Objects with Custom MetadataEnterprise-managed authorization (EMA) with a static keyEnterprise-managed authorization (EMA) with a workspace secretEnterprise-managed authorization (EMA) with Microsoft Entra IDExtended observability — pushing API logs to ClickHouseExtended observability — pushing API logs to Grafana / LokiExtended Observability - Pushing API Logs to your Datadog InstanceFacebook Messenger Webhook SetupFireflies Integration GuideGetting started with WorkableHandling Delegated vs. Application Scopes in Microsoft IntegrationsHiBob & Unified: connection and time off guideHow long are logs retainedHow to access employees and usersHow to add API support for the Create Activity in CrelateHow to Associate a Connection ID with Your End-UserHow to build a Candidate Assessment product withHow to build a candidate sourcing or job board app with Unified.toHow to build a Discord support bot with Unified.to and LangbaseHow to Build a Fintech Application with Unified's Payments APIHow to Build an E-Commerce Product Integration with UnifiedHow to build an invoicing system with Unified.toHow to build Enterprise Search using RAGHow to configure Bullhorn Redirect URI for creating a connectionHow to configure webhooks in HubSpotHow to configure webhooks in Thrive LearningHow to configure webhooks in Toast for UnifiedHow to Connect Anthropic to Real-Time SaaS Data with Unified.to MCP ServerHow to Connect Cohere to Real-Time SaaS Data with Unified.to MCP ServerHow to Connect Google Gemini to Real-Time SaaS Data with Unified.to MCP ServerHow to connect HiBob (Bob) to Unified with OAuth 2.0How to Connect LLMs to Real-Time SaaS Data with Unified.to MCP ServerHow to Connect OpenAI to Real-Time SaaS Data with Unified.to MCP ServerHow to Connect Zoom and Zoom PhoneHow to create a Connection In Microsoft TeamsHow to create a token-based connection in HighlevelHow to Create a Unified.to Connection to HighLevelHow to Create a Xero Connection in Unified.toHow to create and configure webhooksHow to create Connection with HubspotHow to customize portal URLs for Stripe and GoCardlessHow to filter webhook eventsHow-to Get a Private Support Channel for Your Unified IntegrationHow to get help fromHow to get your 8x8 Connect API Key, Account ID and SMS Subaccount ID (optional): Step-by-step guideHow to get your ADP Workforce Now Oauth2 client ID, Oauth2 client secret, Oauth2 PEM certificate and Oauth2 private key: Step-by-step guideHow to get your Amazon S3 AWS Region, AWS S3 Key, AWS S3 Secret and AWS S3 Bucket(s) (optional, comma-separated): Step-by-step guideHow to get your Ashby API Key: Step-by-step guideHow to get your Brex API token: Step-by-step guideHow to get your Bullhorn OAuth2 Client ID, OAuth2 Client Secret, API Username and API Password: Step-by-step guideHow to get your Ceridian Dayforce Username, Password and Client Namespace: Step-by-step guideHow to get your Crelate API key: Step-by-step guideHow to get your Dashlane API Key: Step-by-step guideHow to get your Deel Access Token: Step-by-step guideHow to get your Dialpad API Key: Step-by-step guideHow to get your Discord OAuth 2 credentials and bot tokenHow to get your ELMO client ID and client secret: Step-by-step guideHow to get your Gainsight Client ID, Client Secret and Gainsight API Domain: Step-by-step guideHow to get your Greenhouse API Key and Job board token: Step-by-step guideHow to get your Helpscout API Key: Step-by-step guideHow to get your HiBob Service User ID and Service User Token: Step-by-step guideHow to get your HighLevel API Key and Location ID: Step-by-step guideHow to get your HubSpot developer key and OAuth 2 credentials (Legacy Apps)How to get your Humaans API Key: Step-by-step guideHow to get your iCIMS API Username, API Password and Customer ID: Step-by-step guideHow to get your JobDiva Client ID, Username/email and Password: Step-by-step guideHow to get your Jobvite API Key, API Key Secret and Email: Step-by-step guideHow to get your Lever API Key: Step-by-step guideHow to get your Loxo Agency slug, API Key and Agency ID: Step-by-step guideHow to get your Microsoft Active Directory / Entra ID Client ID, Client Secret and Tenant ID: Step-by-step guideHow to get your Microsoft Azure AD OAuth 2 credentialsHow to get your OAuth 2 credentials for GmailHow to get your OAuth 2 credentials for Microsoft Dynamics 365How to get your OAuth 2 credentials in PipeDriveHow to get your OpenAI API Key: Step-by-step guideHow to get your Paycom SID/Username and Token/Password: Step-by-step guideHow to get your PCRecruiter Username, Password, Database ID, App Key and App ID: Step-by-step guideHow to get your SAP SuccessFactors (OpenID Connect) Username, Password, Client ID, Client Secret, Dependency Name, IAS Host and API URL: Step-by-step guideHow to get your SAP SuccessFactors Username, Company ID, Password and API URL: Step-by-step guideHow to get your Shopify Admin API access token and Store ID: Step-by-step guideHow to get your Wayfair Client ID, Client Secret and Vendor Encrypted Key: Step-by-step guideHow to get your Workable API Token and Subdomain: Step-by-step guideHow to get your yotpo APP Key / Store ID and Secret Key: Step-by-step guideHow to Handle Attachments in Invoice, Bill and Credit MemoHow to Manage Google Ad Manager Orders, Line Items and Creatives with theHow to migrate or import your integrations into Unified.toHow to obtain your GitHub OAuth2 credentialsHow to Power Claude with Live Customer Data Using Unified MCPHow to receive assessment orders from an ATS with Unified.toHow to register a Google developer app and get OAuth 2 credentialsHow to Register a HiBob Developer App and Get OAUTH2 CredentialsHow to register a Salesforce developer app and get OAuth 2 credentialsHow to register a Slack developer account and get OAuth 2 credentialsHow to Register a Workday Developer App and Get OAUTH2 CredentialsHow to Register a Workday Developer App and Get OAUTH2/ SOAP CredentialsHow to Register a ZendeskSell Developer App and Get OAUTH2 CredentialsHow to Register a Zoho Developer App and Get OAUTH2 CredentialsHow to Register an ADP Developer App and Get OAUTH2 CredentialsHow to Register an Atlassian Developer App and Get OAUTH2 CredentialsHow to Register your Facebook OAuth2 ApplicationHow to Register your Google Ads OAuth2 ApplicationHow to Register your MetaAds OAuth2 applicationHow To Request & Write Raw Integration DataHow to Retrieve Microsoft Dynamics 365 Business Central CredentialsHow to set up a custom API URL with a CNAMEHow to Set Up a Google Meet Meeting Bot with UnifiedHow to set up a HiBob marketplace installHow to Set Up a Microsoft Teams Bot with UnifiedHow to Set Up a Microsoft Teams Meeting Bot with UnifiedHow to Set Up a Webex Meeting Bot with UnifiedHow to Set Up a Zoom Meeting Bot with UnifiedHow to set up and configure NotionHow to set up Google Business Profile API access and get OAuth 2 credentialsHow to Set Up LinkedIn Webhooks with UnifiedHow to set up native webhooks for QuickBooks Online with UnifiedHow to set up Slack webhooks using event subscriptionsHow to set up Telegram (bot) with Unified.toHow to set up your scopes in HubSpotHow to setup a Freshbooks developer appHow to setup a TikTok Shop applicationHow to Setup AWS Assume Role for AWS Secret ManagerHow to setup Oracle JD EdwardsHow to Setup Quickbooks DesktopHow to setup Sage 100 with Unified.toHow to test webhooks in the Synthetic Data (Sandbox) environmentHow to troubleshoot unhealthy connectionsHow to troubleshoot unhealthy webhooksHow to Use Decision Models with the Unified GenAI APIHow to use SCIM with the Unified APIHow to use the Passthrough APIHow to Use Unified.to's Generative AI API with OpenAI and ClaudeHow to use User Provisioning and Verification with UnifiedHow virtual webhook retry and recovery worksManaging custom validation rules in SalesforceNetSuite Authentication Setup for UnifiedNotice of Deprecation of Fields and Objects (Nov 2025)Oracle HCM / Taleo OAuth Credentials GuideRetrieval-Augmented Generation (RAG)SalesForce (External Client Apps) on Multiple OrganizationsSAML Single-Sign-OnScaling MCP Tools with Anthropic's (& OpenAI's) Defer LoadingScaling MCP Tools with Anthropic's Programmatic Tool CallingSet Environments for your Unified.to WorkspaceSetting up a Slack Bot Connection with Unified.toSetting up OAuth 2 Credentials for Greenhouse's APIsTrello Connection Guide in UnifiedUnderstanding OAuth2 Authorization flowsUnderstanding Response Time Headers in the Unified APIUnified Assessment API: Embed Assessments Inside ATS PlatformsUnified's MCP ServerUnified MCP Server with LangChain and LangGraphUnlock real-time data with virtual webhooksUse Unified to sign in your users into your applicationVincere OAuth Setup Guide for UnifiedWhy you can't use Unified's OAuth2 credentials to authorize your end users on ProductionWorkable: Creating candidates and attaching them to jobsWorkday vs Workday Legacy — Why Unified.to Supports BothWorking with hierarchical tree data in Storage, Messaging, and KMS APIs
Are we missing anything? Let us know
Was this page helpful?