Workable
Bring new starters, changes and leavers from Workable into every system that needs them, with HR approving each change.
35 ways to read, 18 ways to write, each write switched on by you.
Quality checks
Built and tested with example responses.
- Ready to connect: doneEvery listed action is built in.
- Built and tested with example responses: doneEach action is built from the provider’s published API and tested against example responses, errors, rate limits and paging.
Connected, approved, proven.
The things teams do most with Workable, an example flow with a person in the loop, and what Nexra keeps as proof.
Top actions
- Comment on candidate
candidate_comments.createApproval by rule - Rate candidate
candidate_ratings.createApproval by rule - List time off balances
timeoff_balances.listRead
Example flow
- Workable · List time off balances
timeoff_balances.listDone - Workable · Comment on candidate
candidate_comments.createMaker-checker - Nexra · Record the decision and result in the evidence chainProven
Example workflow. Routine runs go through on their own. Only a change your rules flag, such as one over a limit you set, waits for the right person, who sees the exact change and the rule before it reaches Workable.
What gets logged
- Whether it ran on its own or who approved it, and under which rule
- A fingerprint of the exact request sent to Workable
- Workable's reply: what it created or changed
- One entry in the evidence chain, linked to the one before
Try this in the sandbox
Run the whole flow with test data in your sandbox, then connect your own account when you are ready to go live.
For developers
Technical detail
Read and write Workable candidates, requisitions, departments, employees, time off and time entries, and read jobs, activity, events, org chart and account settings.
Workable Software API docs- Source actions
- 35
- Destination actions
- 18
- Data types
- 37
What you can map
Reads are always available. Writes are off until you switch them on for a connection, and governed writes follow your policies.
account1
- Get accountSource
The connected Workable account's name, description and website.
candidate activities1
- List candidate activitySourceIncremental
Timeline of one candidate (moves, comments, ratings), optionally since a time.
candidate comments1
- Comment on candidateDestinationNot retried automaticallyApproval before production
Adds a comment to the candidate's timeline, optionally restricted by role.
candidate custom attributes1
- Set candidate custom attributeDestinationProvider duplicate protectionApproval before production
Sets one yes/no, number, date or choice custom attribute on a candidate.
candidate files1
- List candidate filesSource
Names and kinds of a candidate's files (preview links are not returned).
candidate offer1
- Get candidate offerSource
The candidate's offer documents (read-only; offer variables with compensation are not returned).
candidate ratings1
- Rate candidateDestinationNot retried automaticallyApproval before production
Adds an internal rating with a comment to a candidate.
candidate stage1
- Move candidateDestinationProvider duplicate protectionApproval before production
Moves a candidate to another pipeline stage.
candidate tags1
- Set candidate tagsDestinationProvider duplicate protectionApproval before production
Replaces the candidate's tags with the given list (an empty list removes all).
candidates4
- Create candidateDestinationNot retried automaticallyApproval before production
Creates a candidate in a job, as sourced (default) or applied.
- Get candidateSource
One candidate with experience, education, skills, tags and social profiles.
- List candidatesSourceIncremental
Candidates across jobs or for one job, optionally updated after a timestamp.
- Update candidateDestinationProvider duplicate protectionApproval before production
Updates candidate profile fields. Skills and tags replace existing values.
custom attributes1
- List candidate custom attributesSource
Account-wide candidate custom attribute definitions.
departments3
- Create departmentDestinationNot retried automaticallyApproval before production
Creates a department, optionally under a parent.
- List departmentsSource
Departments with their parent department.
- Update departmentDestinationProvider duplicate protectionApproval before production
Renames or re-parents a department.
disqualification reasons1
- List disqualification reasonsSource
Reasons available when disqualifying candidates.
employee fields1
- List employee fieldsSource
Employee field definitions with visibility rules (pay, tax, bank, ID and health fields omitted).
employee orgchart1
- List org chartSource
Org chart nodes with manager, title and department.
employees4
- Create employeeDestinationNot retried automaticallyApproval before production
Creates an employee record (draft by default) with job, department, manager and dates.
- Get employeeSource
One employee (personal and compensation fields omitted).
- List employeesSource
Employees in Workable HR with job, manager and department.
- Update employeeDestinationProvider duplicate protectionApproval before production
Updates job, department, manager, dates or names. Omitted fields are unchanged.
events2
- Get eventSource
One interview, call or meeting with attendees and conference link.
- List eventsSource
Interviews, calls and meetings, optionally for a job, candidate or date range.
job activities1
- List job activitySource
Activity stream of one job (moves, comments, disqualifications).
job custom attributes1
- List job custom attributesSource
Candidate custom attributes used on a job.
job members1
- List job teamSource
Members collaborating on a job, with their role.
job questions1
- List job application questionsSource
Questions on a job's application form.
job stages1
- List job stagesSource
Pipeline stages of one job; use the slug when moving candidates.
jobs2
- Get jobSource
One job with description, requirements and benefits.
- List jobsSourceIncremental
Jobs with state, department, location and URLs.
legal entities1
- List legal entitiesSource
Legal entities used for employees.
members1
- List membersSource
Account members with roles (use their IDs as acting members).
recruiters1
- List external recruitersSource
External recruiters (agencies), optionally only those on one job.
requisition attributes1
- List requisition custom attributesSource
Requisition custom attribute definitions (salary-type attributes omitted).
requisitions4
- Create requisitionDestinationNot retried automaticallyApproval before production
Creates a hiring plan requisition. Salary fields are never sent.
- Get requisitionSource
One requisition by code (salary range and salary attributes omitted).
- List requisitionsSourceIncremental
Hiring plan requisitions (salary ranges omitted).
- Update requisitionDestinationProvider duplicate protectionApproval before production
Updates a requisition's owners, location, type, reason, notes or plan date. Salary fields are never changed.
review templates1
- List performance review templatesSource
Performance review templates with their section titles.
sourced candidates1
- Add sourced candidateDestinationNot retried automaticallyApproval before production
Adds a candidate to a job as sourced. Unlike Create candidate, this can never be sent as an application, so the candidate is not emailed.
stages1
- List stagesSource
Account-wide recruitment pipeline stages.
talent pool candidates1
- Add talent pool candidateDestinationNot retried automaticallyApproval before production
Adds a sourced candidate to the talent pool (not to a job). The candidate is not emailed.
time entries3
- Add time entryDestinationNot retried automaticallyApproval before production
Adds a time entry (or clock-in or clock-out) for an employee. Overlapping entries are never archived.
- List time entriesSource
Clock-ins, clock-outs and time entries in a date range.
- Update time entryDestinationProvider duplicate protectionApproval before production
Changes a time entry's clock-in, clock-out or note. Overlapping entries are never archived.
timeoff balances1
- List time off balancesSource
One employee's available, used and carried-over time off per category.
timeoff categories1
- List time off categoriesSource
Time off categories (vacation, sick leave and others).
timeoff requests2
- Request time offDestinationNot retried automaticallyApproval before production
Submits a time off request for an employee; it follows the account's approval flow.
- List time off requestsSource
Time off requests from a date, optionally for given employees or states.
work schedules1
- List work schedulesSource
Work schedules with weekly hours.
Access and limits
- 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.
- Pagination
- paging.next URL (since_id cursor) for jobs, candidates, members and requisitions; offset with totalCount for employees.
- Provider events
- Subscriptions for candidate_created, candidate_moved and employee events. Flows run on demand, on a schedule, or when a scheduled check finds new or changed records.
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 and reverting it (no documented way to suppress candidate emails), relocation, copying candidates, offer approvals, requisition approvals and rejections, member invites, enabling and deletes, department merges and deletes, time-off approvals, time entry archiving, file and document uploads and employee documents are not implemented.
- candidates.create keeps its existing sourced input: sending sourced false treats the candidate as an applicant, which makes Workable email them. Use sourced_candidates.create or talent_pool_candidates.create, which always send sourced true.
- candidates.list and members.list keep their existing optional email filters, which Workable only accepts as query parameters; avoid them where emails must not appear in request URLs.
- Requisitions are created and updated without salary fields; requisition salary ranges and salary-type custom attributes are never returned. Time entries are always written with override_overlapping false, so no entries are archived.
- Time-off and time-tracking lists accept page sizes of 10, 20, 50 or 100 only; Nexra rounds the requested size up.
- Candidate, comment, rating, requisition, department, time-off, time entry and employee creates have no idempotency key; uncertain writes are not repeated automatically.
Developer reference
- Create the Workable Software credentials described above with the narrowest permissions your flows need.
- In Nexra, open Connect, then Connections, then New connection, choose Workable, enter its settings and credentials, and tick only the write actions you need. Connection guide
- Test the connection, then use its actions as flow sources and destinations. Flow guide
Machine-readable detail: GET /api/public/connect/connectors/workable and the Connections API.