Skip to main content

​
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.
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).

​
Prerequisites

1

Lever API key

Generate in Lever → Settings → Integrations → API Credentials. Grant read access to Opportunities, Postings, Offers, and Candidates.
2

Mavera API key

Get your key from Mavera dashboard.
3

Environment variables

​
Jobs

​
Rate Limits & Production Notes

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.
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
  • For OAuth: use token refresh flow; tokens expire in 30 minutes

All Integrations

Lever API Docs

Personas

Focus Groups

Mave Agent

Generate