Jump to Content
API Reference
v2.0
v2.1
Log In
API Reference
Log In
Automation Effort
API Reference
exposeAsMcpTool
Search
JUMP TO
Hire Documentation
Overview
Hire Webhooks
Rate Limits
Frequently Asked Questions
API Deprecations
Tenant API URLs
Hire API Use Cases
Custom Integrations
Slack Integration
Sync with your HRIS
Connecting a Custom Form
Hire Public API
Applicants
List All Applicants
get
Create an Applicant
post
Get Applicant Info
get
Update Applicant Info
put
Delete an Applicant
delete
Advance an Applicant
put
Bulk Advance Multiple Applicants
post
Get Transition History
get
Bulk Transition History for Multiple Applicants
post
duplicate applicants
get
Get Interview Sessions
get
Bulk Interview Sessions for Multiple Applicants
post
Notify applicant
post
Get Latest Applicant
get
Get Applicant Files
get
File Upload to S3
post
Link Applicant to Files in S3
post
exposeAsMcpTool
Labels
List Labels for Applicant
get
Update Label for Applicant
put
List All Labels in Stage
get
Notes
Get Applicant Notes
get
Create Applicant Note
post
Delete Applicant Note
delete
Update Applicant Note
put
transitions
List Archived Reasons
get
List Rejection Reasons
get
Calendar Slots
Create Calendar Slots
post
Book an Available Slot
post
Delete Calendar Slots
delete
Cancel a booked slot
post
List Calendar Slots
get
List Available Slots
get
Data Keys
List data keys
get
Export Management
List Custom Export Templates
get
Create Custom Export
post
Download Custom Export
get
List all Custom Export Templates
get
List All Timestamped Export Templates
get
Download Timestamped Export
get
Create Timestamped Export
post
List Timestamped Export Templates
get
Openings and Stages
List All Openings
get
Create a new opening
post
Retrieve Opening
get
Update opening
put
Delete an opening
delete
List All Opening Stages
get
Retrieve stage
get
Hiring Goals
List Hiring Goals
get
Create a new hiring goal
post
Update Hiring Goal
put
Delete a Hiring Goal
delete
Locations and Location Groups
List Location Groups
get
Create a new Location Group
post
Retrieve Location Group
get
Update Location Group
put
Delete a Location Group
delete
List Locations
get
Create a new Location
post
Retrieve Location
get
Update Location
put
Delete a Location
delete
Openings
Reassign Opening to Different Workflow (Alpha)
post
Option Bank
List All Option Banks
get
Create Option Bank
post
Get Option Bank
get
Replace Option Bank
put
Delete Option Bank
delete
Remove from Option Bank
delete
Append to Option Bank
put
Positions
List Positions
get
Create a new Position
post
Retrieve Position
get
Update Position
put
Delete a Position
delete
Roles
List user roles
get
Shifts
List shifts
get
Users
List User Activities
get
Get user opening access
get
change user opening access
put
Create User
post
Get Users
get
Update User
put
Delete User
delete
Posthire Worker Management
List Workers
get
Get Worker Info
get
Update A Worker
patch
Activate A Worker
post
Deactivate A Worker
post
Workflows
List all Workflows
get
Delete a Workflow
delete
Worker Experience Documentation
Authentication
Webhooks and External API Calls
Custom Attribute Webhooks
Universal Tasks Webhooks (Onboard)
External Processing API (Compliance)
Embedding the Worker Portal
Partner Tasks
API Deprecations
Worker Experience Public API
workers
count workers
get
find one worker
get
partially update one existing worker
patch
delete one worker
delete
find many workers
get
create one or multiple workers
post
partially update many existing worker
patch
delete many workers
delete
Terminate a worker access
post
message one or many workers
post
Create or update a worker custom attribute value
put
Delete a worker custom attribute
delete
Import worker(s) with I9 profile with pre-filled data
post
Create or update a worker's custom attributes values
put
Get the worker profile without sensitive filters
get
jobs
count jobs
get
find one job
get
replace one job which exists or not
put
partially update one existing job
patch
delete one job
delete
find many jobs
get
create one or multiple jobs
post
replace many jobs which exists or not
put
partially update many existing job
patch
delete many jobs
delete
customAttributes
count customAttributes
get
find one customAttribute
get
replace one customAttribute which exists or not
put
partially update one existing customAttribute
patch
delete one customAttribute
delete
find many customAttributes
get
create one or multiple customAttributes
post
replace many customAttributes which exists or not
put
partially update many existing customAttribute
patch
delete many customAttributes
delete
locations
count locations
get
find one location
get
replace one location which exists or not
put
partially update one existing location
patch
delete one location
delete
find many locations
get
create one or multiple locations
post
replace many locations which exists or not
put
partially update many existing location
patch
delete many locations
delete
locationGroups
count locationGroups
get
find one locationGroup
get
replace one locationGroup which exists or not
put
partially update one existing locationGroup
patch
delete one locationGroup
delete
find many locationGroups
get
create one or multiple locationGroups
post
replace many locationGroups which exists or not
put
partially update many existing locationGroup
patch
delete many locationGroups
delete
locationGroupTrees
count locationGroupTrees
get
find one locationGroupTree
get
replace one locationGroupTree which exists or not
put
partially update one existing locationGroupTree
patch
delete one locationGroupTree
delete
find many locationGroupTrees
get
create one or multiple locationGroupTrees
post
replace many locationGroupTrees which exists or not
put
partially update many existing locationGroupTree
patch
delete many locationGroupTrees
delete
employers
count employers
get
find one employer
get
replace one employer which exists or not
put
partially update one existing employer
patch
delete one employer
delete
find many employers
get
create one or multiple employers
post
replace many employers which exists or not
put
partially update many existing employer
patch
delete many employers
delete
brands
count brands
get
find one brand
get
replace one brand which exists or not
put
partially update one existing brand
patch
delete one brand
delete
find many brands
get
create one or multiple brands
post
replace many brands which exists or not
put
partially update many existing brand
patch
delete many brands
delete
get a company default brand
get
companies
count companies
get
find one company
get
replace one company which exists or not
put
partially update one existing company
patch
find many companies
get
replace many companies which exists or not
put
partially update many existing company
patch
companyAttributes
count companyAttributes
get
find one companyAttribute
get
replace one companyAttribute which exists or not
put
partially update one existing companyAttribute
patch
delete one companyAttribute
delete
find many companyAttributes
get
create one or multiple companyAttributes
post
replace many companyAttributes which exists or not
put
partially update many existing companyAttribute
patch
delete many companyAttributes
delete
companyAttributeSets
count companyAttributeSets
get
find one companyAttributeSet
get
replace one companyAttributeSet which exists or not
put
partially update one existing companyAttributeSet
patch
delete one companyAttributeSet
delete
find many companyAttributeSets
get
create one or multiple companyAttributeSets
post
replace many companyAttributeSets which exists or not
put
partially update many existing companyAttributeSet
patch
delete many companyAttributeSets
delete
eins
count eins
get
find one ein
get
replace one ein which exists or not
put
partially update one existing ein
patch
delete one ein
delete
find many eins
get
create one or multiple eins
post
replace many eins which exists or not
put
partially update many existing ein
patch
delete many eins
delete
copilotAuditLogs
count copilotAuditLogs
get
find one copilotAuditLog
get
replace one copilotAuditLog which exists or not
put
partially update one existing copilotAuditLog
patch
delete one copilotAuditLog
delete
find many copilotAuditLogs
get
create one or multiple copilotAuditLogs
post
replace many copilotAuditLogs which exists or not
put
partially update many existing copilotAuditLog
patch
delete many copilotAuditLogs
delete
users
Retrieve a short-lived authenticated URL for a worker's portal
get
apikeys
count apikeys
get
find one apikey
get
delete one apikey
delete
find many apikeys
get
delete many apikeys
delete
create a new API key based on caller rights
post
opensignups
count opensignups
get
find one opensignup
get
partially update one existing opensignup
patch
find many opensignups
get
create one or multiple opensignups
post
partially update many existing opensignup
patch
storedFiles
count storedFiles
get
find one storedFile
get
partially update one existing storedFile
patch
delete one storedFile
delete
find many storedFiles
get
partially update many existing storedFile
patch
delete many storedFiles
delete
Create a file and get an upload presigned URL for an object storage in the edm bucket
post
Create a file and get an upload presigned URL for an object storage in the attachments bucket
post
generate a signed file url to access a file
get
Create a file and get an upload presigned URL for an object storage in the custom scripts bucket
post
Upload one or two files from a publicly accessible URL to our object storage. The combined file must not exceed 15MB.
post
Create a file and get an upload presigned URL for an object storage in the csv imports bucket
post
List files from CSV imports storage folder only
get
Count files from CSV imports storage folder only
get
signDocs
count signDocs
get
find one signDoc
get
find many signDocs
get
signatureRequests
Retrieve a link or download files linked to a signatureRequest document
get
Return the attachment of a signatureRequest as a buffer
get
taskFlows
count taskFlows
get
find one taskFlow
get
partially update one existing taskFlow
patch
delete one taskFlow
delete
find many taskFlows
get
create one or multiple taskFlows
post
partially update many existing taskFlow
patch
delete many taskFlows
delete
clone task flow(s)
post
Check if a calendar group is used by any task flows
get
Retrieve all workers of a taskFlow with data such as completion rate of tasks
get
Retrieve all information about one worker and its taskFlow completion
get
Retrieve all taskFlows for a given worker with data such as completion rate of tasks
get
tasks
count tasks
get
find one task
get
partially update one existing task
patch
delete one task
delete
find many tasks
get
create one or multiple tasks
post
partially update many existing task
patch
delete many tasks
delete
assignedTasks
count assignedTasks
get
find one assignedTask
get
partially update one existing assignedTask
patch
find many assignedTasks
get
partially update many existing assignedTask
patch
mark an webhook assignedTask as done programmatically and resend it
post
retrigger an webhook programmatically for an assignedTask
post
trigger the init process of a task again
post
trigger the init process of a task again
post
mark an assignedTask as done programmatically
post
i9Profiles
count i9Profiles
get
find one i9Profile
get
find many i9Profiles
get
Get the i9 form attached to a profile submission
get
Get the i9 form attached to a profile submission
get
Get the i9 e-verify attached to a profile latest submission
get
w4Profiles
count w4Profiles
get
find one w4Profile
get
find many w4Profiles
get
accept w4 submission of a profile
post
Get the w4 form attached to a profile submission
get
workbright
Get the document assigned to a profile
get
hirePapi
Reject the Hire Papi Profile of an applicant
post
Set rejected to `false` on the Hire Papi Profile of an applicant
post
yardstik
Query Yardstik for the full list of account packages associated with the account defined by the API key
get
partner
Retrieve an assigned partner task
get
Add a new partner event to an assigned partner task
post
todo-workers
Get worker task flows
get
Api endpoint to get workers by task date
get
Get counts of workers with tasks in different statuses
get
processes-dashboard-pending-tasks
Provides a summary of pending tasks for a current employer user
get
participants
count participants
get
find one participant
get
find many participants
get
questionBanks
count questionBanks
get
find one questionBank
get
partially update one existing questionBank
patch
delete one questionBank
delete
find many questionBanks
get
create one or multiple questionBanks
post
partially update many existing questionBank
patch
delete many questionBanks
delete
surveys
count surveys
get
find one survey
get
partially update one existing survey
patch
delete one survey
delete
find many surveys
get
create one or multiple surveys
post
partially update many existing survey
patch
delete many surveys
delete
themes
count themes
get
find one theme
get
partially update one existing theme
patch
delete one theme
delete
find many themes
get
create one or multiple themes
post
partially update many existing theme
patch
delete many themes
delete
defaultNotificationTemplates
count defaultNotificationTemplates
get
find one defaultNotificationTemplate
get
partially update one existing defaultNotificationTemplate
patch
delete one defaultNotificationTemplate
delete
find many defaultNotificationTemplates
get
create one or multiple defaultNotificationTemplates
post
partially update many existing defaultNotificationTemplate
patch
delete many defaultNotificationTemplates
delete
pulseSettings
count pulseSettings
get
find one pulseSettings
get
partially update one existing pulseSettings
patch
delete one pulseSettings
delete
find many pulseSettings
get
create one or multiple pulseSettings
post
partially update many existing pulseSettings
patch
delete many pulseSettings
delete
attendancePolicies
Find attendance policy for a given location
get
Find attendance policy for a given location group
get
allowances
Create an allowance and associate it with a location
post
Delete one or more allowances
post
shifts
count shifts
get
find one shift
get
find many shifts
get
create one or multiple shifts
post
Update shifts, validated by rules. Fails with a 409 if there are any blockers. Note: When adding breaks use v4 uuid.
patch
/api/serviceattendance/processes/shifts/{shiftUuid}
delete
/api/serviceattendance/processes/shifts/{locationUuid}/publish
post
/api/serviceattendance/processes/shifts/{shiftUuid}/resetNextVersion
post
Publish an individual shift
post
timesheets
Returns exported headers, rows, filename for timesheets. Specify target timesheets by uuid or by filter
get
count timesheets
get
find one timesheet
get
partially update one existing timesheet
patch
find many timesheets
get
create one or multiple timesheets
post
partially update many existing timesheet
patch
Marks a timesheet as deleted and cancels scheduled events
post
/api/serviceattendance/processes/timesheets/{timesheetUuid}/addClockEvent
patch
demands
count demands
get
find one demand
get
find many demands
get
demand
Creates bulk demand for a given period
post
Creates shifts for a specific demand or list of demands
post
allowanceSettings
Find allowance settings for a given location
get
Find allowance settings for a given location group
get
Count allowance for a given location
get
Count allowance for a given location group
get
automaticBreakSettings
Find automatic break settings for a given location
get
Find automatic break settings for a given location group
get
Count automatic break rules for a given location
get
Count automatic break rules for a given location group
get
automaticBreakRules
Create an automatic break rule and associate it with a location
post
Delete one or more automatic break rules
post
holidayRules
Create a holiday rule and associate it with a location
post
Delete one or more holiday rules
post
holidayRuleSettings
Find holiday rule settings for a given location
get
Find holiday rule settings for a given location group
get
Count holiday rule settings for a given location
get
Count holiday rule settings for a given location group
get
employmentProfiles
count employmentProfiles
get
find one employmentProfile
get
find many employmentProfiles
get
exposeAsMcpTool
