Workable

Read and write Workable candidates (create, update, move, comment, tag) and employees, and read jobs, stages, members, requisitions and departments.

Bring candidates in from sourcing channels, keep pipelines moving and push hires into the Workable HRIS or downstream systems.

Build a flow with Workable Provider API documentation

Source actions

Destination actions

Data types

Validation status

Implemented · fixture tested.

Implementation is checked against provider-shaped fixtures for every action, authentication failures, rate limits, pagination and duplicate safety. Provider sandbox and authorised account validation are recorded separately when credential-backed runs are completed.

What you can map

candidate comments

Comment on candidate
Destination
Not retried automatically
Adds a comment to the candidate's timeline, optionally restricted by role.

candidate offer

Get candidate offer
Source
The candidate's offer documents (read-only; offer variables with compensation are not returned).

candidate stage

Move candidate
Destination
Duplicate protected
Moves a candidate to another pipeline stage.

candidate tags

Set candidate tags
Destination
Duplicate protected
Replaces the candidate's tags with the given list (an empty list removes all).

candidates

Create candidate
Destination
Not retried automatically
Creates a candidate in a job, as sourced (default) or applied.
Get candidate
Source
One candidate with experience, education, skills, tags and social profiles.
List candidates
Source
Incremental
Candidates across jobs or for one job, optionally updated after a timestamp.
Update candidate
Destination
Duplicate protected
Updates candidate profile fields. Skills and tags replace existing values.

departments

List departments
Source
Departments with their parent department.

disqualification reasons

List disqualification reasons
Source
Reasons available when disqualifying candidates.

employees

Create employee
Destination
Not retried automatically
Creates an employee record (draft by default) with job, department, manager and dates.
Get employee
Source
One employee (personal and compensation fields omitted).
List employees
Source
Employees in Workable HR with job, manager and department.
Update employee
Destination
Duplicate protected
Updates job, department, manager, dates or names. Omitted fields are unchanged.

job stages

List job stages
Source
Pipeline stages of one job; use the slug when moving candidates.

jobs

Get job
Source
One job with description, requirements and benefits.
List jobs
Source
Incremental
Jobs with state, department, location and URLs.

members

List members
Source
Account members with roles (use their IDs as acting members).

requisitions

List requisitions
Source
Incremental
Hiring plan requisitions (salary ranges omitted).

stages

List stages
Source
Account-wide recruitment pipeline stages.

Authentication

Workable API access token

Plans and access

API access tokens are available on all Workable plans; employee endpoints require Workable HR. Tokens carry scopes chosen at creation (r_jobs, r_candidates, w_candidates, r_employees, w_employees, r_account). r_employees exposes confidential employee data.

Test environment

A Workable free trial account can be used for testing.

Rate limits

Workable rate limits per token and returns HTTP 429 with Retry-After; the current reference does not publish the limit values.

Provider events

Subscriptions for candidate_created, candidate_moved and employee events. Nexra event triggers are not yet available; flows run on demand or on a schedule.

Before you build a flow

Job and requisition salary ranges and offer document variables (compensation) are not returned.
Employee personal fields (birth date, gender, marital status, salary, tax and identity documents) are never written or returned.
Disqualification, ratings, relocation, copying candidates, talent pool candidates and file uploads are not implemented.
Candidate, comment and employee creates have no idempotency key; uncertain writes are not repeated automatically.
Rate limit values and the employee create body's minimum required fields are not published in the reference (unverified).