Lever

List job postings and create candidates in Lever ATS.

On this page

Connect
Call it from a workflow
Actions (6)
addFeedbackToOpportunity
getOpportunity
listOpportunityFeedback
listOpportunityForms
updateOpportunityStage
custom_api_call
Details

Connect

Auth type: API key (secret_text). Paste the API key (or token) from the provider's settings into the connect dialog. It is encrypted at rest and only decrypted on the server when an action runs.

In the editor: Backend panel, Integrations tab, then Connect. This connects it for the project.
For every project in a workspace: Workspace settings, Integrations.
Owners and admins choose which integrations members may connect in the admin panel (Integrations tab), and can attach their own OAuth app there.

Call it from a workflow

Pass the action name and its input. The call resolves with { success, output, error? }; a missing connection resolves with success false and the reason. See ctx.integrations.invoke and ctx.integrations.call.

Native workflow

// .workflow.js (native ctx)
export async function run(ctx) {
  const res = await ctx.integrations.invoke("lever", "addFeedbackToOpportunity", {
    "performAs": "<performAs>",
    "opportunityId": "<opportunity id>",
    "feedbackFields": {}
  });
  if (!res.success) throw new Error(res.error);
  ctx.log.info("Lever answered", { output: res.output });
}

defineWorkflow module

// defineWorkflow module (@app/sdk ctx)
import { defineWorkflow } from "@app/sdk";

export default defineWorkflow({
  id: "lever-addfeedbacktoopportunity",
  name: "Lever: Add feedback to opportunity",
  description: "Calls Lever when a row is created.",
  trigger: { type: "entity_event", entity: "tickets", event: "created" },
  async run(ctx, event) {
    const res = await ctx.integrations.call("lever", {
      "action": "addFeedbackToOpportunity",
      "performAs": "<performAs>",
      "opportunityId": "<opportunity id>",
      "feedbackFields": {}
    }) as { success: boolean; error?: string };
    if (!res.success) throw new Error(res.error);
  },
});

From an app (connector proxy)

curl -X POST "$APP_ORIGIN/__appbricx/connector-proxy/lever/addFeedbackToOpportunity" \
  -H "Authorization: Bearer $APP_KEY" \
  -H "content-type: application/json" \
  -d '{"props":{"performAs":"<performAs>","opportunityId":"<opportunity id>","feedbackFields":{}}}'

Actions

addFeedbackToOpportunityin catalog

Add feedback to opportunity. Provide feedback to a candidate after an interview

Input	Type	Description
`performAs`required	id (picked from your account)	Feedback author
`opportunityId`required	text	Opportunity ID
`panelId`optional	id (picked from your account)	If you select one, you must select an interview too
`interviewId`optional	id (picked from your account)	Mandatory is you select an interview panel
`feedbackTemplateId`optional	id (picked from your account)	Ignored if you select an interview panel and an interview
`feedbackFields`required	object (depends on other props)	Fields

getOpportunityin catalog

Get opportunity. Retrieve a single opportunity, i.e. an individual's unique candidacy or journey for a given job position

Input	Type	Description
`opportunityId`required	text	Opportunity ID
`expand`optional	array	Expand

listOpportunityFeedbackin catalog

List opportunity feedback. Get all feedback for a given opportunity, optionally for a given template

Input	Type	Description
`opportunityId`required	text	Opportunity ID
`template`optional	id (picked from your account)	Feedback template

listOpportunityFormsin catalog

List opportunity forms. Get all forms for a given opportunity, optionally for a given form template

Input	Type	Description
`opportunityId`required	text	Opportunity ID
`template`optional	id (picked from your account)	Form template

updateOpportunityStagein catalog

Update opportunity stage. Change an Opportunity's current stage

Input	Type	Description
`opportunityId`required	text	Opportunity ID
`stage`required	id (picked from your account)	Stage

custom_api_call

Custom API Call. Make a custom API call to a specific endpoint

Input	Type	Description
`url`required	object (depends on other props)	url
`method`required	one of "GET" \| "POST" \| "PATCH" \| "PUT" \| "DELETE" \| "HEAD"	Method
`headers`required	object	Authorization headers are injected automatically from your connection.
`queryParams`required	object	Query Parameters
`body_type`optional	one of "none" \| "json" \| "form_data" \| "raw"	Body Type
`body`optional	object (depends on other props)	Body
`response_is_binary`optional	boolean	Enable for files like PDFs, images, etc.
`failsafe`optional	boolean	No Error on Failure
`timeout`optional	number	Timeout (in seconds)
`followRedirects`optional	boolean	Follow redirects

Details

Id: lever
Category: HR
Tags: ats, recruiting, hiring, candidates
Package: @activepieces/piece-lever@0.1.4
Tier: Community