Jump to Content
API Reference
v2.0
v2.1
Log In
API Reference
Log In
Automation Effort
API Reference
List user roles
Search
JUMP TO
Hire Documentation
Overview
Hire Webhooks
Rate Limits
Frequently Asked Questions
API Deprecations
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
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
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
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
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
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
Upload one or two files from a publicly accessible URL to our object storage. The combined file must not exceed 15MB.
post
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
Get the w4 documents 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
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
demand
Creates bulk demand for a given period
post
List user roles
get
https://api.fountain.com/v2/roles
List all roles for the account
Language
Shell
Node
Ruby
PHP
Python
Credentials
Header
Header
RESPONSE
Click
Try It!
to start a request and see the response here!