Lever
Connect Lever so Suger 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 Suger AI agent read and update your hiring pipeline — opportunities, postings, requisitions, interviews, and feedback — from a Suger 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. Suger 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 Suger Admin role — connecting, disconnecting, and running an integration’s actions are all admin-only in Suger.
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 Suger console, open Settings → Integrations and click Connect on Lever.
- Paste the key into User name and save.
Suger AI Tools
When Lever is connected, the Suger AI agent can work your hiring pipeline through Suger’s 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 Suger 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.