Skip to main content
Lever logo
  • Category: hr talent & recruitment
  • Auth: API_KEY, OAUTH2
  • Composio-managed OAuth available? No
  • Tools: 64
  • Triggers: 0
  • Slug: LEVER
  • Version: 20261101_00

Tools

Slug: LEVER_ADD_OPPORTUNITY_SOURCESTool to add sources to an opportunity. Use when you need to attribute specific recruitment channels or sources to an existing opportunity.

Input Parameters

array
required
List of source names to add to the opportunity. Sources are specified as strings identical to those displayed in the Lever interface. If a source does not exist, it will be created automatically.
string
UID of the user to perform this action on behalf of
string
required
UID of the opportunity to which sources will be added

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LEVER_ADD_OPPORTUNITY_TAGSTool to add tags to an opportunity. Use when you need to append labels or categorize an existing opportunity.

Input Parameters

array
required
List of tag names to add to the opportunity. Adding tags does not replace existing tags; it appends new ones.
string
UID of the user to perform this action on behalf of
string
required
UID of the opportunity to add tags to

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LEVER_CREATE_FORMTool to create a completed profile form submission for a candidate’s opportunity profile. Use when you need to submit a filled form based on an existing template.

Input Parameters

array
required
An array of field objects with their submitted values. Must include all required fields from the template
boolean
A flag indicating whether the form should be marked as secret
string
Specifies the user ID on whose behalf the action is being performed
string
required
The unique identifier (UUID) of the opportunity. The candidateId can be used as the opportunityId
string
required
The unique identifier (UUID) of an existing profile form template that this form is based on

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LEVER_CREATE_FORM_TEMPLATETool to create a profile form template for an account. Use when you need to create a new form template with custom fields.

Input Parameters

string
required
The name of the form template
string
The group UID to associate with this form template
array
required
An array of form fields that define the structure of the form. At least one field is required
string
Form instructions for users completing the form
boolean
Boolean indicating if the form is secret by default

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LEVER_CREATE_INTERVIEWTool to create an interview on an externally-managed panel in Lever. Use when scheduling a new interview for an opportunity on a panel where externallyManaged is true.

Input Parameters

integer
required
Scheduled interview date and time as milliseconds since epoch
string
Notes or additional information about the interview
string
required
Panel UID where the interview will be added. Must be an externally managed panel
string
Subject line for the interview
integer
required
Interview duration in minutes, minimum 1 minute
string
Location details for the interview
string
required
UID of the user on whose behalf to perform this operation
string
required
Opportunity ID in path parameter
array
required
List of interviewers for this interview. At least one interviewer is required. Each interviewer must have either an id or email
string ("once" | "daily" | "frequently" | "none")
Feedback reminder frequency setting
string
Feedback template ID to assign to the interview

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LEVER_CREATE_NOTETool to create a note on an opportunity profile or add a threaded comment to an existing note.

Input Parameters

integer
Optional note score (1-4). Values outside range are rejected by API
string
required
Note text body; supports @mentions to notify users
boolean
If true, visible only to SIP users and @mentioned users
string
If provided, creates a threaded comment on the existing note with this UID
integer
Creation timestamp in milliseconds since epoch for historical notes; cannot be in the future
string
UID of the user on whose behalf to perform this operation
string
required
UID of the opportunity to attach this note to
boolean
If true, notify all followers of the candidate

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LEVER_CREATE_OPPORTUNITYTool to create a new candidate opportunity in Lever. Use when adding a new candidate to the system with automatic email-based deduplication.

Input Parameters

string
required
Full name of the candidate
array
Array of tags for organizing candidates
Array of URLs for the candidate (e.g., LinkedIn, GitHub, portfolio)
string
User ID of the opportunity owner
boolean
Whether to parse resume file for information extraction (requires resumeFile upload via multipart/form-data)
string
Stage ID for the opportunity in the recruitment pipeline
array
required
Array of email addresses for the candidate. Used for automatic deduplication - if an email matches an existing contact, the opportunity will be linked to that contact.
string
Origin of the candidate (e.g., ‘applied’, ‘sourced’, ‘referred’)
array
Array of phone objects with type and value properties
string
Contact ID to link the opportunity to an existing contact instead of using email-based deduplication
array
Array of source identifiers for tracking candidate origin
object
Archive information for an opportunity.
string
Candidate’s professional headline or current position
string
Candidate’s location information
array
Array of posting UIDs to associate with the opportunity. Note: Only one posting per request is allowed.
integer
Creation timestamp in milliseconds since epoch for backdating historical opportunities. Cannot be in the future.
array
Array of user IDs who should follow this opportunity
string
UID of the user on whose behalf to perform this operation
boolean
If true, perform action as the posting owner

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LEVER_CREATE_PANELTool to create a new interview panel for an opportunity. Use when scheduling interviews for a candidate.

Input Parameters

string
Note attached to the panel
string
required
Timezone name for the panel in IANA format (e.g., America/New_York)
array
required
Non-empty list of interview objects for the panel
string
required
User UID to perform this action on behalf of
string
External URL associated with this panel
string
required
UID of the opportunity to create the panel for
array
Application UIDs to associate with the panel; defaults to all active applications if omitted
string ("once" | "daily" | "frequently" | "none")
Feedback reminder frequency for the panel; defaults to daily if not specified

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LEVER_CREATE_REQUISITIONTool to create a new requisition in Lever for tracking hiring needs. Use when establishing job requisitions to manage headcount and hiring workflows.

Input Parameters

string
required
Requisition title or name
string
UUID of the associated team
string
UUID of the requisition owner
string ("open" | "closed")
Current requisition status. Valid values for creation: open, closed (defaults to open if not specified)
boolean
Indicates if the position is a replacement/backfill
string
UUID of the job location
integer
Custom creation timestamp in Unix timestamp (milliseconds)
array
Array of posting UUID strings to link requisition to job postings
array
Array of custom field objects with fieldId, value, and optional text
string
UUID of the Lever user who is the hiring manager
string
Internal comments/notes about the requisition
integer
required
Total number of positions to be filled (must be at least 1)
string
required
Unique identifier/code for the requisition
string
UUID of the compensation band
string
Employment type designation (e.g., full-time, part-time, contract)

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LEVER_CREATE_REQUISITION_FIELDTool to create a custom requisition field schema for use across requisitions. Use when establishing requisition field schemas for your account.

Input Parameters

string
required
Unique identifier for the field
string
required
Human-readable field name/display text
string ("number" | "text" | "date" | "object" | "dropdown")
required
Field type. Valid values: ‘number’, ‘text’, ‘date’, ‘object’, ‘dropdown’
array
Required for ‘dropdown’ type fields. Array of option objects
boolean
Whether the field is mandatory. Defaults to false if not specified
array
Required for ‘object’ type fields. Array of subfield objects

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LEVER_CREATE_REQUISITION_FIELD_OPTIONAdd new options to a Lever dropdown requisition field without replacing its existing choices. Use this to expand the available choices for requisitions.

Input Parameters

array
required
Array of option objects to add to the dropdown field. This adds new options without replacing existing ones.
string
required
The identifier of the dropdown requisition field to add options to

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LEVER_CREATE_UPLOADUpload a file temporarily to Lever for use in posting applications. Files are available for 24 hours and have a 30MB size limit.

Input Parameters

object
File to upload to Lever. Maximum file size is 30MB. Uploaded files expire after 24 hours.
string
Name of the file to upload (for testing with file_content)
string
Base64 encoded file content (for testing purposes)
string
MIME type of the file (for testing with file_content)

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LEVER_CREATE_USERTool to create a new user in the Lever system. Use when adding a new team member with configurable access role.

Input Parameters

string
required
The user’s full name or preferred name
string
required
The user’s email address
string
User’s job title
string
User’s manager ID (reference to another user)
string ("super admin" | "admin" | "team member" | "limited team member" | "interviewer")
User’s access level in the system. Default is ‘interviewer’ if not specified. Options: ‘super admin’, ‘admin’, ‘team member’, ‘limited team member’, ‘interviewer’
string
Unique ID for user in external HR directory

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LEVER_DEACTIVATE_USERTool to deactivate a user in the Lever system. Use when you need to prevent a user from logging in while preserving their historical records. Deactivated users remain in the system for historical record keeping but can no longer log in and use Lever.

Input Parameters

string
required
The user’s unique identifier

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LEVER_DELETE_FORM_TEMPLATETool to delete a profile form template from account. Use when you need to remove a custom API-created form template. System templates cannot be deleted.

Input Parameters

string
required
The unique identifier (ID) of the form template to delete. Only custom templates created via API can be deleted, not system templates

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LEVER_DELETE_INTERVIEWDelete an interview from an opportunity’s externally managed panel on behalf of a user. Removing the panel’s last interview also deletes the panel.

Input Parameters

string
required
Interview UID to delete
string
required
User UID on whose behalf the delete is performed
string
required
Opportunity UID from which to delete the interview

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LEVER_DELETE_NOTETool to delete a note on an opportunity. Use when you need to remove an API-created note.

Input Parameters

string
required
UID of the note to delete (only notes created via API can be deleted)
string
required
UID of the opportunity from which to delete the note

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LEVER_DELETE_PANELTool to delete a panel from an opportunity. Use when you need to remove an externally managed panel on behalf of a user. Only panels with externallyManaged=true can be deleted.

Input Parameters

string
required
Panel UID to delete
string
required
User UID on whose behalf the delete is performed
string
required
Opportunity UID from which to delete the panel

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LEVER_DELETE_REQUISITIONDelete a requisition from a Lever account by its ID.

Input Parameters

string
required
Unique identifier (UUID) of the requisition to delete

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LEVER_DELETE_REQUISITION_FIELDDelete a requisition field from the account. Existing requisitions using a deleted field schema become read-only.

Input Parameters

string
required
The unique identifier (ID) of the requisition field to delete. Only deletes requisition fields that are no longer in use

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LEVER_DELETE_REQUISITION_FIELD_OPTIONTool to remove specific options from a dropdown requisition field. Use when you need to delete dropdown choices without removing the entire field.

Input Parameters

array
required
Array of UUIDs representing the options to be removed from the dropdown field
string
required
The unique identifier of the dropdown requisition field from which to remove options

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LEVER_DOWNLOAD_FILETool to download a file associated with an opportunity. Use when you have opportunity and file UIDs and need to retrieve the actual file content.

Input Parameters

string
required
UID of the file to download.
string
required
UID of the opportunity that owns the file.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LEVER_GET_FILETool to retrieve metadata for a single file on an opportunity. Use when you have opportunity and file UIDs and need details like name, size, and status before downloading.

Input Parameters

string
required
UID of the file to retrieve.
string
required
UID of the opportunity that owns the file.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LEVER_GET_FORMTool to retrieve a specific profile form for an opportunity. Use when you need to fetch details of a form including field values and completion status.

Input Parameters

string
required
The unique identifier (UUID) of the form to retrieve
string
required
The unique identifier (UUID) of the opportunity

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LEVER_GET_FORM_TEMPLATETool to retrieve a single form template by unique identifier. Use when you need to obtain a reference template for creating a new profile form.

Input Parameters

string
required
The unique identifier (ID) of the form template to retrieve

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LEVER_GET_INTERVIEWTool to retrieve a single interview for an opportunity. Use when you need to fetch detailed interview information by opportunity and interview UIDs.

Input Parameters

string
required
The unique identifier (UUID) of the interview
string
required
The unique identifier (UUID) of the opportunity

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LEVER_GET_NOTETool to retrieve a single note for an opportunity. Use when you need to fetch detailed information for a specific note after confirming the opportunity and note IDs.

Input Parameters

string
required
The unique identifier (UUID) of the note to retrieve
string
required
The unique identifier (UUID) of the opportunity containing the note

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LEVER_GET_OPPORTUNITYTool to retrieve detailed information about a single opportunity. Use when you need to fetch comprehensive candidate details including contact information, stage progression, sources, tags, and applications.

Input Parameters

string
Comma-separated list of fields to expand into full objects instead of just IDs. Supported values: applications, contact, owner, stage, stageChanges, sourcedBy
string
required
The unique identifier (UID) of the opportunity to retrieve

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LEVER_GET_PANELTool to retrieve a single interview panel for an opportunity. Use when you need to fetch detailed panel info by opportunity and panel UIDs.

Input Parameters

string
required
UID of the panel to retrieve
array
Expand eligible sub-objects inline (e.g., ‘user’, ‘stage’); repeat for multiple values
array
Limit returned attributes to those specified; repeat for multiple values
string
required
UID of the opportunity containing the panel

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LEVER_GET_REQUISITIONRetrieve a single requisition by ID, including hiring status and headcount. The response schema may omit associated postings and other requisition details.

Input Parameters

string
Comma-separated list of fields to expand into full objects instead of just IDs
string
Comma-separated list of attributes to include in the response
string
required
The unique identifier (UID) of the requisition to retrieve

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LEVER_GET_REQUISITION_FIELDTool to retrieve detailed information about a single custom requisition field by ID. Use when you need to fetch the schema and configuration of a specific requisition field.

Input Parameters

string
required
The unique identifier (ID) of the requisition field to retrieve

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LEVER_GET_STAGETool to retrieve detailed information about a single stage by its UUID. Use when you need to fetch stage details from the recruiting pipeline workflow.

Input Parameters

string
required
The unique identifier (UUID) of the stage to retrieve

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LEVER_GET_USERTool to retrieve detailed information about a single user by their UUID. Use when you need to fetch complete user profile data including access role, contact links, and organizational details.

Input Parameters

string
required
The unique identifier (UUID) of the user to retrieve

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LEVER_LIST_FILESTool to list all files on an opportunity. Use after obtaining the opportunity UID.

Input Parameters

integer
Max items per page (1-100). Defaults to server default
string
Pagination offset token from a previous response
string
required
UID of the opportunity to list files for
integer
Include files uploaded before this timestamp (in ms since epoch), inclusive
integer
Include files uploaded from this timestamp (in ms since epoch), inclusive

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LEVER_LIST_FORMSTool to list all profile forms for an opportunity. Use when you need to retrieve all forms associated with a candidate’s profile.

Input Parameters

integer
Number of results to return per page. Range: 1-100. Default: 100
string
Pagination offset token for retrieving the next page of results
string
required
The unique identifier (UUID) of the opportunity for which to retrieve profile forms

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LEVER_LIST_FORM_TEMPLATESTool to list all active form templates. Use when you need to retrieve all profile form templates for an account.

Input Parameters

integer
Specifies the number of items to include in the response for pagination
array
Supports expanding user IDs and posting ID into full objects. If the expand option is used, it will take precedence over the include option
string
The pagination offset for list requests
array
Parameter for filtering results to include only specific attributes (e.g., id, text, group)

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LEVER_LIST_INTERVIEWSList a page of interviews for an opportunity, with pagination controls for additional results.

Input Parameters

integer
Max items per page (1-100). Defaults to server default of 100
array
Expand inline related objects where supported; repeat for multiple values
string
Pagination offset token from a previous response
array
Limit returned fields to those specified; repeat for multiple values
string
required
The unique identifier (UID) of the opportunity/candidate

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LEVER_LIST_NOTESList notes on a Lever opportunity profile using its opportunity ID. Results can be paginated with a page limit and offset; supported fields and related objects can be included or expanded.

Input Parameters

integer
Max items per page (1-100). Defaults to server default
array
Expand inline related objects where supported; e.g., ‘user’
string
Pagination offset token from a previous response
array
Limit returned fields to those specified; repeat for multiple values
string
required
UID of the opportunity whose notes to list

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LEVER_LIST_OFFERSTool to list offers for an opportunity. Use when you have an opportunity UID and need to retrieve its offers.

Input Parameters

integer
Max items per page (1-100). Defaults to server default
array
Expand inline related objects (only ‘creator’); repeat for multiple values
string
Pagination offset token from a previous response
array
Limit returned fields to those specified; repeat for multiple values
string
required
UID of the opportunity to list offers for

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LEVER_LIST_OPPORTUNITIESList a page of hiring pipeline opportunities with optional filters for contact, posting, stage, tags, time ranges, and other criteria. Results default to non-confidential opportunities; request all confidentiality levels to include confidential opportunities where authorized.

Input Parameters

string
Filter by tag
string
Filter by candidate email
integer
Max items per page (1-100). Defaults to 100 if not specified
array
Expand related object IDs into full objects. Supported values: applications, contact, owner, stage, stageChanges, sources, sourcedBy
string
Pagination offset token from a previous response
string
Filter by origin
string
Filter by source
array
Limit returned fields to those specified. If used with expand, expand takes precedence
string
Filter by snoozed status (true/false)
string
Filter by archived status (true/false)
string
Filter by pipeline stage ID
string
Filter by specific contact ID
string
Filter by specific job posting ID
string
Filter opportunities created before this time (ISO 8601 timestamp)
string
Filter opportunities updated before this time (ISO 8601 timestamp)
string
Filter opportunities advanced before this time (ISO 8601 timestamp)
string
Filter opportunities archived before this time (ISO 8601 timestamp)
string
Filter by confidentiality level
string
Filter opportunities created after this time (ISO 8601 timestamp)
string
Filter opportunities updated after this time (ISO 8601 timestamp)
string
Filter opportunities advanced after this time (ISO 8601 timestamp)
string
Filter by archive reason ID
string
Filter opportunities archived after this time (ISO 8601 timestamp)
string
Filter by archived posting ID

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LEVER_LIST_PANELSTool to list all interview panels for an opportunity. Use when you need to retrieve all panels associated with a specific opportunity UID.

Input Parameters

integer
Max items per page (1-100). Defaults to server default
array
Expand inline related objects where supported; repeat for multiple values
string
Pagination offset token from a previous response to fetch the next page
array
Limit returned fields to those specified; repeat for multiple values
string
required
The unique identifier (UID) of the opportunity

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LEVER_LIST_POSTINGSList job postings with optional filters for state, team, department, location, commitment, level, tag, or update timestamp. Results default to non-confidential postings and published postings on the public job site.

Input Parameters

string
Filter postings by tag
string
Filter postings by team. Multiple values can be OR’ed together
string
Filter postings by job level (e.g., Senior, Junior)
integer
Max items per page (1-100). Defaults to 100 if not specified
string ("published" | "internal" | "closed" | "draft" | "pending" | "rejected")
Filter by posting state.
string
Expand related objects inline (applies to the response of that request only)
string
Pagination offset token from a previous response
string
Filter postings by geographic location. Multiple values can be OR’ed together
string
Filter postings by commitment type (e.g., Fulltime, Intern). Multiple values can be OR’ed together
string
Filter postings by department. Multiple values can be OR’ed together
boolean
Filter confidential postings. Requires API key with access to confidential data
integer
Filter postings updated after this timestamp (Unix timestamp in milliseconds)

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LEVER_LIST_REFERRALSTool to list all referrals for an opportunity. Use when you have an opportunity UID and need to retrieve its referrals.

Input Parameters

integer
Max items per page (1-100). Defaults to server default
array
Comma-separated list of fields to expand inline (e.g., ‘referrer’ to expand referrer user object)
string
Pagination offset token from a previous response
string
required
The unique identifier (UID) of the opportunity

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LEVER_LIST_REQUISITION_FIELDSList requisition field schemas in a Lever account, with optional filtering by field type.

Input Parameters

string ("number" | "text" | "date" | "object" | "dropdown")
Filter by the top-level field type. Valid values: ‘number’, ‘text’, ‘date’, ‘object’, ‘dropdown’
integer
Max items per page for pagination. Must be a positive integer
string
Pagination offset token from a previous response
boolean
Filter fields by whether they are required

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LEVER_LIST_REQUISITIONSTool to list all requisitions with filtering and pagination. Use when you need to retrieve requisitions, optionally filtered by status, code, confidentiality, or creation date.

Input Parameters

integer
Number of requisitions to return per page (1-100)
array
Expand referenced objects inline (e.g., hiringManager, owner, department, team)
string
Pagination offset token from a previous response
string
Filter by requisition status
string
Filter requisitions created on or before this timestamp
string
Filter by confidentiality level
string
Filter requisitions created on or after this timestamp
string
Filter by requisition code

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LEVER_LIST_RESUMESList resume records for a specified Lever opportunity, including available file metadata and parsed resume data. Filter by upload time and use the page limit and offset token to retrieve further results; resumes without an upload date are filtered by their creation date.

Input Parameters

integer
Max items per page (1-100). Defaults to server default
string
Pagination offset token from a previous response
string
required
UID of the opportunity to list resumes for
integer
Include files uploaded before this timestamp (in ms since epoch), inclusive
integer
Include files uploaded from this timestamp (in ms since epoch), inclusive

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LEVER_LIST_SOURCESTool to list all recruitment sources in your Lever account. Use when you need to retrieve information about sources (e.g., LinkedIn, Indeed, referrals, career site).

Input Parameters

integer
Max items per page (1-100). Defaults to 100 if not specified
string
Pagination offset token from a previous response

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LEVER_LIST_STAGESTool to retrieve all pipeline stages in your Lever account. Use when you need to list all hiring stages.

Input Parameters

integer
Max items per page (1-100). Defaults to 100
string
Pagination offset token from a previous response

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LEVER_LIST_TAGSTool to list all tags in your Lever account. Use when you need to retrieve tags used to categorize candidates, opportunities, and postings.

Input Parameters

integer
Max items per page. Defaults to server default if not specified
string
Pagination offset token from a previous response

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LEVER_LIST_USERSTool to retrieve all active users in your Lever account with optional filters. Use when you need to list users, filter by email, access role, or include deactivated users.

Input Parameters

string
Filters results to return users matching a specific email address
integer
A limit on the number of objects to be returned. The limit can range between 1 and 100 items. Default is 100
string
An offset token specifying the next page of results to return. Must be an offset token returned from a previous paginated request
string
Filters results by user access role (e.g., ‘Interviewer’, ‘Limited Team Member’, ‘Team Member’, ‘Admin’, ‘Super Admin’)
boolean
When set to true, includes deactivated users in the response. By default, only active users are returned
string
Filters results by external directory identifier

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LEVER_REACTIVATE_USERTool to reactivate a previously deactivated user in the Lever system. Use when you need to restore login and Lever access to a user. After reactivation, the user’s deactivatedAt field will be set to null, indicating the user is active again.

Input Parameters

string
required
The user’s unique identifier

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LEVER_REMOVE_OPPORTUNITY_SOURCESTool to remove sources from an opportunity. Use when you need to delete source attributions from a candidate’s recruitment tracking information.

Input Parameters

array
required
List of source names to remove from the opportunity. Source names must exactly match existing sources on the opportunity (e.g., ‘Twitter’, ‘LinkedIn’, ‘Indeed’).
string
UID of the user to perform this action on behalf of
string
required
UID of the opportunity from which sources will be removed

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LEVER_REMOVE_OPPORTUNITY_TAGSTool to remove tags from an opportunity. Use when you need to detach specific labels from an existing opportunity before further updates or archiving.

Input Parameters

array
required
List of tag names to remove from the opportunity. These tags must exist on the opportunity.
string
UID of the user to perform this action on behalf of
string
required
UID of the opportunity from which to remove tags

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LEVER_UPDATE_FORM_TEMPLATETool to update an existing profile form template. Use when you need to modify a form template’s name, instructions, fields, or other properties.

Input Parameters

string
The name of the form template
string
The group UID to associate with this form template
array
An array of form fields that define the structure of the form. Each field must include its ID for updates
string
Form instructions for users completing the form
string
required
The unique identifier (ID) of the form template to update
boolean
Boolean indicating if the form is secret by default

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LEVER_UPDATE_INTERVIEWUpdate an interview on an externally managed panel. The update replaces the interview object, and omitted fields are deleted.

Input Parameters

integer
required
Scheduled time as milliseconds since epoch
string
Interview note
string
required
Interview panel UID
string
Interview subject
integer
required
Duration in milliseconds, minimum 1
string
Interview location
string
required
Interview ID in path
string
required
UID of the user on whose behalf to perform this operation
string
required
Opportunity ID in path
array
required
List of interviewers (at least 1)
string ("once" | "daily" | "frequently" | "none")
Feedback reminder frequency
string
Feedback form template ID

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LEVER_UPDATE_NOTEUpdate an API-created note on an opportunity profile. The update atomically replaces the entire note, including its comments and metadata.

Input Parameters

string
required
UID of the note to update
string
UID of the user who began the note thread
integer
Overall score for the note thread (1-4); applies to the note as a whole
boolean
If true, note is visible only to SIP users and @mentioned users
array
Array of comment values for the note; replaces existing comments. Only the ‘value’ field is required on each entry.
integer
Creation timestamp in ms since epoch for the note
integer
Completion timestamp in ms since epoch for the note
string
required
UID of the opportunity containing the note

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LEVER_UPDATE_PANELUpdate an externally managed interview panel for an opportunity, including its interviews and other panel details. This is a full replacement: omitted fields are deleted.

Input Parameters

string
Note attached to the panel
string
required
UID of the panel to update
string
required
Timezone name for when the panel occurs (IANA format, e.g., America/Los_Angeles)
array
required
Non-empty list of interview objects for the panel
string
required
User UID to perform this update on behalf of
string
External URL associated with this panel
string
required
UID of the opportunity containing the panel
array
Application UIDs associated with the panel; omit to default to all active applications; empty array invalid
string ("once" | "daily" | "frequently" | "none")
Frequency of feedback reminders; one of once, daily, frequently, none; defaults to daily

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LEVER_UPDATE_REQUISITIONUpdate an existing requisition’s details, such as name, headcount and status. This is a full resource update: omitted fields are deleted or reset to defaults.

Input Parameters

string
required
Requisition title or name
string
UUID of the associated team or team name
string
UUID of the requisition owner
string ("open" | "closed")
Current requisition status. Valid values for updates: open, closed
boolean
Indicates if the position is a replacement/backfill
string
UUID of the job location or location name
string
UUID of the associated department
array
Array of posting UUID strings to link requisition to job postings
string
required
The unique identifier (UUID) of the requisition to update
object
Dictionary of custom fields where keys are field IDs and values are the field values (string, number, boolean, array, or object)
string
UUID of the Lever user who is the hiring manager
string
Internal comments/notes about the requisition
integer
required
Total number of positions to be filled (must be at least 1)
string
Confidentiality level of the requisition
string
required
Unique identifier/code for the requisition
integer
Time-to-fill end timestamp (Unix timestamp in milliseconds)
string
UUID of the compensation band or compensation band details object
string
Employment type designation (e.g., full-time, part-time, contract)
integer
Time-to-fill start timestamp (Unix timestamp in milliseconds)

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LEVER_UPDATE_REQUISITION_FIELDTool to update an existing requisition field in Lever. Use when modifying requisition field properties. IMPORTANT: This is an atomic update - include all properties you want to keep, as omitted properties will be deleted.

Input Parameters

string
required
The ID of the requisition field (must match the path parameter)
string
required
Human-readable field name/display text
string ("number" | "text" | "date" | "object" | "dropdown")
required
Field type. Valid values: ‘number’, ‘text’, ‘date’, ‘object’, ‘dropdown’
array
Required for ‘dropdown’ type fields. Array of option objects with id and text
array
Required for ‘object’ type fields. Array of subfield objects
boolean
required
Whether the field is mandatory
string
required
The ID of the requisition field to update (path parameter)

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LEVER_UPDATE_REQUISITION_FIELD_OPTIONUpdate the display text of one or more existing options in a Lever dropdown requisition field. Identify the field and supply each option’s ID and new text; the rest of the field does not need to be replaced.

Input Parameters

array
required
Array of option objects to update. Each object must include the option’s id and the new text value.
string
required
The identifier of the dropdown requisition field containing the options to update

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LEVER_UPDATE_USERTool to update an existing user in the Lever system. Use when modifying user information such as name, email, access role, or job details. WARNING: This performs a full resource update - all fields will be overwritten, and missing optional fields will be reset to defaults.

Input Parameters

string
required
The user’s preferred name. Required field that will overwrite the existing name.
string
required
The unique identifier (UUID) of the user to update
string
required
The user’s email address. Required field that will overwrite the existing email.
string
User’s job title. If not provided, this field will be reset.
string
User’s manager ID (reference to another user). If not provided, this field will be reset.
string
required
User’s access role in the system. Required field. Can be ‘super admin’, ‘admin’, ‘team member’, ‘limited team member’, ‘interviewer’, or a custom role ID. WARNING: Resetting accessRole to ‘interviewer’ will result in a user losing all of their followed profiles.
string
Unique ID for user in external HR directory. If not provided, this field will be reset.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LEVER_UPLOAD_FILETool to upload a file permanently to an opportunity. Use when you need to attach resumes, documents, or other files directly to a candidate’s opportunity profile. Files have a 30MB size limit.

Input Parameters

object
File to upload to the opportunity. Maximum file size is 30MB. This file is permanently attached to the opportunity.
string
Name of the file to upload (for testing with file_content)
string
required
UID of the user on whose behalf to perform the file upload operation.
string
required
UID of the opportunity to attach the file to.
string
Base64 encoded file content (for testing purposes)
string
MIME type of the file (for testing with file_content)

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not