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.

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

   export LEVER_API_KEY="your_lever_api_key"
   export MAVERA_API_KEY="mvra_live_xxxxx"
   

---

Jobs

#	Job	Lever Data	Mavera Surface	Output
1	Pipeline Stage → Candidate Experience Focus Group	Opportunities by stage	Personas + Focus Groups	Stage-by-stage experience ratings
2	Source Effectiveness → Recruitment Marketing	Postings + source data	Mave + Generate	Source-optimized recruitment content
3	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

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