Lever
Connect Lever so Fours AI can work with your opportunities, postings, and interview feedback.
Overview
Lever is a talent acquisition platform combining an applicant tracking system with CRM-style candidate nurturing. Connecting it lets the Fours AI agent read and update your hiring pipeline — opportunities, postings, requisitions, interviews, and feedback — from a Fours workflow or chat.
Org-Level vs User-Level
Org-Level: Supported. One Lever API key serves the whole organization.
User-Level: Not currently available. Lever does support OAuth, but issuing an OAuth client requires acceptance into Lever’s partner integration program — Lever’s own team creates the app and sends the credentials after a sandbox build and a live review. Until that completes, Lever is org-only.
How the connection works
Lever authenticates with HTTP Basic, where the API key is the username and the password is empty. Fours stores the key and builds that header for you, so the connect form has a single field.
Create Integration (Org-Level)
Prerequisites
- A Lever account on a plan that includes API access.
- Super Admin on that Lever account. The API credentials page is not visible to other roles.
- The Fours Admin role — connecting, disconnecting, and running an integration’s actions are all admin-only in Fours.
Authenticate by API key
- In Lever, go to Settings → Integrations and API and open the API credentials tab.
- Generate a new API key and copy it. See Lever’s Generating and using API credentials for the current walkthrough.
- In the Fours console, open Settings → Integrations and click Connect on Lever.
- Paste the key into User name and save.
Fours AI Tools
When Lever is connected, the Fours AI agent can work your hiring pipeline through Fours’ built-in tools (61 actions).
Org-level: All tools run under the org API key, so the agent’s reach matches that key’s permissions.
| Capability | What the agent can do |
|---|---|
| Opportunities | Create opportunities and move them through the pipeline — stage, archive state, tags, sources, and links (e.g. create-opportunity, update-opportunity-stage, update-opportunity-archived) |
| Candidate detail | Read an opportunity’s resumes, referrals, panels, file actions, and contact record (e.g. get-opportunity-resumes, update-contact) |
| Postings | Read, list, and update job postings, apply to one, and read posting users (e.g. get-postings, update-posting, apply-posting) |
| Requisitions | Full create/read/update/delete on requisitions, plus their configurable fields (e.g. create-requisition, get-requisition-fields) |
| Interviews & panels | Create panels, and update or delete scheduled interviews (e.g. create-panel, update-interview) |
| Feedback | Manage feedback forms and templates end to end (e.g. create-feedback, update-feedback-template) |
| Notes | Add, read, and delete notes on a candidate (e.g. create-note, delete-note) |
| Users | Create users, update them, and deactivate or reactivate accounts (e.g. create-user, deactivate-user) |
| Webhooks | Create, list, and delete Lever webhooks (e.g. create-webhook, get-webhooks) |
| Reference data | Read stages, archive reasons, disposition stages, sources, and tags (e.g. get-stages, get-archive-reasons) |
| Compliance | Read EEO survey responses — anonymous (get-eeo-responses) or including personally identifiable information (get-eeo-responses-pii) |
| Deletion audit | List records Lever has deleted — applications, opportunities, and postings (e.g. get-opportunities-deleted) |
Edit Integration
Editing is not supported. To rotate the key or point Fours at a different Lever account, delete the integration and create it again.
Delete Integration
Click the 🗑️ button next to Lever in the Integrations list. The stored key is destroyed with the integration record, and any workflow or agent depending on Lever tools stops working immediately. Revoke the key in Lever too if you want to cut access from that side.
Spotted something wrong or out of date on this page? Tell us and we'll correct it.