--- title: Lever API Integration on Truto slug: lever category: ATS canonical: "https://truto.one/integrations/detail/lever/" --- # Lever API Integration on Truto **Category:** ATS **Status:** Beta ## Unified APIs ### Unified User Directory API - **Users** — The User object represents a User. ### Unified ATS API - **Activities** — The activity on a candidate performed by a user. - **Applications** — The applications represent an application for a job. - **Attachments** — The attachments represent an attachment for a candidate. - **Candidates** — The candidates represent a candidate. - **Job Form Fields** — The form fields used to apply to a job. - **Job Interview Stages** — The job interview stages represent a job interview stage. - **Jobs** — The jobs represent a job. - **Tags** — The tags represent a tag for a candidate. - **Users** — The users represent a user. ## How it works 1. **Link your customer's Lever account.** Use Truto's frontend SDK; we handle every OAuth and API key flow so you don't need to create the OAuth app. 2. **Authentication is automatic.** Truto refreshes tokens, stores credentials securely, and injects them into every API request. 3. **Call Truto's API to reach Lever.** The Proxy API is a 1-to-1 mapping of the Lever API. 4. **Get a unified response format.** Every response uses a single shape, with cursor-based pagination and data in the `result` field. ## Use cases - **Automate candidate screening when applications hit specific pipeline stages** — SaaS companies offering AI screening or assessment tools can monitor Lever pipeline stages via Truto's Unified ATS API and automatically trigger evaluations when candidates reach a configured stage — eliminating manual handoffs between recruiter workflows and external tools. - **Push external assessment results and AI scores directly into Lever** — Assessment platforms, background check providers, and AI screening tools need to write results back into the candidate's Lever profile so recruiters never leave their ATS. Truto's Activities, Tags, and Attachments resources enable posting scorecards, status updates, and PDF reports to the candidate timeline. - **Sync job postings to external distribution channels in real time** — Job board aggregators and programmatic advertising platforms can read active Jobs from Lever through Truto and distribute them across thousands of channels, then write back inbound applicants as new Candidates and Applications — making external sourcing seamless for recruiters. - **Build interview scheduling workflows using Lever's user and application data** — Scheduling tools need to know which candidates are ready for interviews and who the interviewers are. By reading Applications, Job Interview Stages, and Users through Truto, scheduling SaaS products can orchestrate panel availability checks and write confirmed interview details back as Activities. - **Inject sourced candidates into Lever without creating duplicates** — Sourcing and talent intelligence platforms can use Truto's Candidates and Applications resources to push passive candidates into Lever, leveraging existing candidate data to handle deduplication and ensure clean pipeline data for recruiting teams. ## What you can build - **Stage-triggered assessment delivery** — Automatically send coding tests or skill assessments when a Lever candidate reaches a configured Job Interview Stage, using real-time reads of Applications and stage data. - **AI scorecard write-back to candidate profiles** — Post structured AI evaluation summaries and match scores as Activities on the candidate's Lever timeline, with Tags like 'Tier-1-Match' for native filtering by recruiters. - **Resume and attachment extraction pipeline** — Download candidate resumes and portfolios via the Attachments resource to feed into parsing engines, AI screeners, or compliance review workflows. - **One-click candidate injection from external sources** — Create new Candidates, Applications, and Attachments in Lever when someone applies on a third-party job board, so the record appears as if they applied directly on the company's career page. - **Interviewer panel sync via User Directory** — Pull the full list of Lever Users — recruiters, hiring managers, and interviewers — through the Unified User Directory API to map interview panels, assign tasks, or check permissions in your product. - **Dynamic job and stage mapping UI** — Fetch a customer's Jobs and Job Interview Stages to render dropdowns in your product's configuration screen, letting end users map your workflows to their specific Lever pipeline without manual entry. ## FAQs ### What authentication method does the Lever integration use through Truto? Lever uses OAuth 2.0 for authentication. Truto manages the full OAuth flow including token refresh — notably, Lever's access tokens expire every hour, and Truto handles this automatically so your integration doesn't break mid-sync. ### How does Truto handle Lever's rate limits? Lever enforces strict API rate limits. Truto manages rate limiting, retry logic, and backoff strategies transparently, so your application doesn't need to implement custom throttling code when reading or writing Lever data. ### What Unified APIs cover Lever, and which resources are available? Lever is supported under two Unified APIs: the Unified ATS API (Activities, Applications, Attachments, Candidates, Job Form Fields, Job Interview Stages, Jobs, Tags, Users) and the Unified User Directory API (Users). These cover the most common read and write patterns for ATS integrations. ### How does Truto handle Lever's unique Opportunity vs. Contact data model? Lever uses a non-standard data model where 'Opportunities' represent job-specific applications and 'Contacts' represent people. Truto's Unified ATS API normalizes this into standard Candidates and Applications resources, so you don't need to learn or manage Lever's proprietary entity relationships. ### Can I write data back to Lever through Truto, or is it read-only? Truto supports both read and write operations on Lever resources. Common write patterns include creating Candidates and Applications, posting Activities (internal notes with scores or summaries), adding Tags, and uploading Attachments like PDF reports or offer letters. ### Does Truto handle pagination when pulling large datasets from Lever? Yes. Truto abstracts Lever's pagination logic entirely. When you query resources like Candidates or Applications, Truto handles cursor-based pagination behind the scenes and returns consistent, complete result sets through the Unified API. ## Related reading - [How to Integrate with the Lever API (2026 Engineering Guide)](https://truto.one/blog/how-to-integrate-with-the-lever-api-2026-engineering-guide/) — A technical guide for engineering teams integrating the Lever API. Covers OAuth 2.0 token lifecycle, offset pagination, rate limits, webhooks, and the Opportunity data model. - [How to Integrate Multiple ATS Platforms (Greenhouse, Lever, Workable)](https://truto.one/blog/how-to-integrate-multiple-ats-platforms-greenhouse-lever-workable/) — Learn how to integrate Greenhouse, Lever, and Workable APIs with concrete field mapping tables, cursor translation patterns, and LLM-ready response normalization via a unified ATS API.