> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mavera.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Lever

> Integrate Mavera with Lever — pipeline stage candidate experience, source effectiveness for recruitment marketing, and offer acceptance analysis

## Overview

Pull data from **Lever** (Opportunities, Postings, Offers, Sources, Stages) → analyze with **Mavera** (Personas, Focus Groups, Mave Agent, Generate) → get persona-validated insights for recruiting operations, candidate experience, and employer branding teams.

<Info>
  **Lever API** — Base URL: `https://api.lever.co/v1`. Auth: HTTP Basic (API key as username, blank password) or OAuth 2.0. Rate limits: **10 req/sec steady, 20 burst**. Pagination via `offset` (next cursor returned in response).
</Info>

***

## Prerequisites

<Steps>
  <Step title="Lever API key">Generate in Lever → Settings → Integrations → API Credentials. Grant read access to Opportunities, Postings, Offers, and Candidates.</Step>
  <Step title="Mavera API key">Get your key from [Mavera dashboard](https://app.mavera.io/settings/api-keys).</Step>

  <Step title="Environment variables">
    ```bash theme={"dark"}
    export LEVER_API_KEY="your_lever_api_key"
    export MAVERA_API_KEY="mvra_live_xxxxx"
    ```
  </Step>
</Steps>

***

## Jobs

| # | Job                                                                                                       | Lever Data                  | Mavera Surface                      | Output                               |
| - | --------------------------------------------------------------------------------------------------------- | --------------------------- | ----------------------------------- | ------------------------------------ |
| 1 | [Pipeline Stage → Candidate Experience Focus Group](/integrations/lever/candidate-experience-focus-group) | Opportunities by stage      | Personas + Focus Groups             | Stage-by-stage experience ratings    |
| 2 | [Source Effectiveness → Recruitment Marketing](/integrations/lever/source-recruitment-marketing)          | Postings + source data      | Mave + Generate                     | Source-optimized recruitment content |
| 3 | [Offer Acceptance Analysis](/integrations/lever/offer-acceptance-analysis)                                | Accepted vs declined offers | Focus Groups (Ranking + open-ended) | Acceptance factor analysis           |

***

## Rate Limits & Production Notes

| Lever Endpoint | Limit                       | Strategy                                          |
| -------------- | --------------------------- | ------------------------------------------------- |
| All endpoints  | 10 req/sec steady, 20 burst | 100ms delay; exponential backoff on 429           |
| Pagination     | Cursor-based (`offset`)     | Follow `next` field; never hardcode page numbers  |
| Bulk exports   | Use Data Export API         | For 10,000+ records, request a CSV export instead |

<Warning>
  Lever's **10 req/sec** sustained limit is stricter than most ATS APIs. Jobs that iterate per-opportunity (like pulling offers for each) can exhaust the limit quickly. Batch requests and cache stage/source data.
</Warning>

**Checklist:**

* HTTP Basic auth: API key as username, empty password — encode as `base64(key:)`
* Always check `next` field for pagination cursor; `null` means last page
* Store `LEVER_API_KEY` in secrets manager
* Monitor Mavera credits at [Dashboard](https://app.mavera.io/settings/usage)
* For OAuth: use token refresh flow; tokens expire in 30 minutes

***

<CardGroup cols={3}>
  <Card title="All Integrations" icon="plug" href="/integrations" />

  <Card title="Lever API Docs" icon="file-lines" href="https://hire.lever.co/developer/documentation" />

  <Card title="Personas" icon="user" href="/features/personas" />

  <Card title="Focus Groups" icon="users" href="/features/focus-groups" />

  <Card title="Mave Agent" icon="brain" href="/features/mave-agent" />

  <Card title="Generate" icon="wand-magic-sparkles" href="/features/generate" />
</CardGroup>