Workable

Overview

Pre-built tooling

Pre-built integrations

Access requirements

Setup guide

Useful links

API gotchas

Pre-built tooling

✅ Authorization

Tools	Status
Pre-built authorization (API Key)	✅
Pre-built authorization UI	✅
Custom authorization UI	✅
End-user authorization guide	✅
Expired credentials detection	✅

✅ Read & write data

Tools	Status
Pre-built integrations	✅
API unification	✅
2-way sync	✅
Webhooks from Nango on data modifications	✅
Real-time webhooks from 3rd-party API	🚫 (time to contribute: <48h)
Proxy requests	✅

✅ Observability & data quality

Tools	Status
HTTP request logging	✅
End-to-end type safety	✅
Data runtime validation	✅
OpenTelemetry export	✅
Slack alerts on errors	✅
Integration status API	✅

✅ Customization

Tools	Status
Create or customize use-cases	✅
Pre-configured pagination	🚫 (time to contribute: <48h)
Pre-configured rate-limit handling	✅
Per-customer configurations	✅

Others

Function name	Description	Type	Source code
approve-timeoff-request	Approve or reject a pending time-off request.	Action	🔗 Github
copy-candidate	Copy a candidate into another job, leaving the original untouched.	Action	🔗 Github
create-candidate	Create a candidate at a specific job.	Action	🔗 Github
create-comment	Create a comment on the applicant’s timeline.	Action	🔗 Github
create-department	Create a new department	Action	🔗 Github
create-employee-document	Attach a document to an employee record from a hosted URL	Action	🔗 Github
create-employee	Create a new HR employee record.	Action	🔗 Github
create-subscription	Subscribe a target URL to a Workable event	Action	🔗 Github
create-talent-pool-candidate	Create a candidate directly in the account talent pool (not tied to any job).	Action	🔗 Github
create-time-entries-bulk	Create up to 500 time entries across employees in one call.	Action	🔗 Github
create-time-entry	Record a single clock-in/clock-out or manual time entry for an employee.	Action	🔗 Github
create-timeoff-request	Submit a new time-off request for an employee.	Action	🔗 Github
deactivate-member	Deactivate an account member (reversible in principle via enable-member).	Action	🔗 Github
delete-department	Permanently delete a department.	Action	🔗 Github
delete-subscription	Unsubscribe (delete) a webhook subscription.	Action	🔗 Github
delete-time-entry	Archive/delete a time entry.	Action	🔗 Github
disqualify-candidate	Disqualify (or mark withdrawn) a candidate.	Action	🔗 Github
get-account	Retrieve a single account by subdomain.	Action	🔗 Github
get-candidate-offer	Retrieve a candidate’s latest offer, if any.	Action	🔗 Github
get-candidate	Retrieve full candidate details by id	Action	🔗 Github
get-employee-orgchart	Retrieve the reporting-line org chart, optionally scoped to one employee.	Action	🔗 Github
get-employee	Retrieve full HR detail for a single employee.	Action	🔗 Github
get-event	Retrieve a single scheduled event by id.	Action	🔗 Github
get-job-application-form	Retrieve the structured application-form field definitions for a job.	Action	🔗 Github
get-job	Retrieve a single job by shortcode	Action	🔗 Github
invite-member	Invite a new account member by email	Action	🔗 Github
list-accounts	List accounts accessible to the current token.	Action	🔗 Github
list-candidate-activities	List a candidate’s activity stream (comments, moves, ratings, disqualifications).	Action	🔗 Github
list-candidate-files	List files attached to a candidate’s profile (resume, attachments).	Action	🔗 Github
list-candidates	List candidates with optional job/stage/email/date filters.	Action	🔗 Github
list-collaboration-permissions	List which account roles can perform which collaboration actions.	Action	🔗 Github
list-custom-attributes	List the account’s custom attribute definitions.	Action	🔗 Github
list-departments	List the account’s departments.	Action	🔗 Github
list-disqualification-reasons	List the account’s configured disqualification reasons.	Action	🔗 Github
list-employee-documents	List documents attached to an employee record.	Action	🔗 Github
list-employee-fields	List the account’s configured employee custom-field/schema definitions.	Action	🔗 Github
list-employees	List HR employee records.	Action	🔗 Github
list-events	List scheduled recruiting events (calls, interviews, meetings).	Action	🔗 Github
list-job-activities	List a job’s activity stream (opens, applications, closures)	Action	🔗 Github
list-job-candidates	List candidates for a specific job	Action	🔗 Github
list-job-custom-attributes	List custom attributes configured for a specific job.	Action	🔗 Github
list-job-members	List account members collaborating on a specific job	Action	🔗 Github
list-job-questions	List a job’s application questions	Action	🔗 Github
list-job-recruiters	List external recruiters collaborating on a specific job.	Action	🔗 Github
list-job-stages	List the pipeline stages configured for a specific job.	Action	🔗 Github
list-jobs	List account jobs with optional state/date filters.	Action	🔗 Github
list-legal-entities	List the account’s legal entities/locations/sites (HR org structure).	Action	🔗 Github
list-members	List account members.	Action	🔗 Github
list-permission-sets	List the account’s available custom permission sets/roles. Use the name field (not id/label) when assigning custom roles via update-member/invite-member.	Action	🔗 Github
list-recruiters	List external recruiters on the account.	Action	🔗 Github
list-requisitions	List headcount requisitions (Hiring Plan feature).	Action	🔗 Github
list-stages	List the account’s recruitment pipeline stages.	Action	🔗 Github
list-subscriptions	List active webhook subscriptions.	Action	🔗 Github
list-time-entries	List time-tracking entries with employee/date/duration filters.	Action	🔗 Github
list-timeoff-balances	Get an employee’s current time-off balances by category.	Action	🔗 Github
list-timeoff-categories	List the account’s time-off categories (PTO, sick leave, etc).	Action	🔗 Github
list-timeoff-requests	List time-off requests with date, state, and employee filters.	Action	🔗 Github
list-work-schedules	List the account’s configured work schedules.	Action	🔗 Github
move-candidate	Move a candidate to a different pipeline stage.	Action	🔗 Github
rate-candidate	Add a new rating/evaluation for a candidate at their current stage.	Action	🔗 Github
relocate-candidate	Move a candidate to another job, deleting the original candidate record.	Action	🔗 Github
revert-candidate-disqualification	Undo a candidate disqualification, restoring them to their prior stage.	Action	🔗 Github
update-candidate-custom-attribute	Set a custom attribute value on a candidate	Action	🔗 Github
update-candidate-rating	Create or update the acting member’s evaluation for a candidate’s current (or specified) stage.	Action	🔗 Github
update-candidate-tags	Replace a candidate’s tag list.	Action	🔗 Github
update-candidate	Update candidate fields	Action	🔗 Github
update-employee	Update an existing employee.	Action	🔗 Github
update-member	Update an existing member’s roles/collaboration rules.	Action	🔗 Github
update-time-entry	Update an existing time entry’s times or note.	Action	🔗 Github
candidates-activities	Sync activity streams (comments, moves, ratings, disqualifications) for each candidate	Sync	🔗 Github
candidates-offer	Sync each candidate’s latest offer, where one exists.	Sync	🔗 Github
candidates	Sync candidates across all jobs and the talent pool	Sync	🔗 Github
custom-attributes	Sync account-level custom attribute definitions	Sync	🔗 Github
departments	Sync account departments.	Sync	🔗 Github
disqualification-reasons	Sync the account’s configured disqualification reasons.	Sync	🔗 Github
employees	Sync HR employee records.	Sync	🔗 Github
events	Sync scheduled recruiting events (calls, interviews, meetings).	Sync	🔗 Github
jobs-candidates	Sync candidates scoped to each job.	Sync	🔗 Github
jobs-questions	Sync application questions for each job.	Sync	🔗 Github
jobs-stages	Sync the pipeline stages configured for each job.	Sync	🔗 Github
jobs	Sync account jobs	Sync	🔗 Github
legal-entities	Sync HR legal entities/locations/sites org structure	Sync	🔗 Github
members	Sync account members.	Sync	🔗 Github
permission-sets	Sync the account’s custom permission sets/roles.	Sync	🔗 Github
recruiters	Sync external recruiters on the account.	Sync	🔗 Github
requisitions	Sync headcount requisitions (Hiring Plan feature)	Sync	🔗 Github
stages	Sync account-level recruitment pipeline stages.	Sync	🔗 Github
subscriptions	Sync the account’s registered webhook subscriptions	Sync	🔗 Github
time-entries	Sync time-tracking clock-in/clock-out entries.	Sync	🔗 Github
timeoff-balances	Sync current-cycle time-off balances per employee.	Sync	🔗 Github
timeoff-categories	Sync the account’s time-off categories.	Sync	🔗 Github
timeoff-requests	Sync employee time-off requests and their approval state.	Sync	🔗 Github
work-schedules	Sync the account’s configured work schedules.	Sync	🔗 Github

Access requirements

Pre-Requisites	Status	Comment
Paid dev account	❓
Paid test account	❓
Partnership	❓
App review	❓
Security audit	❓

Setup guide

No setup guide yet.

Need help getting started? Get help in the community.

Contribute improvements to the setup guide by editing this page

Useful links

Workable offers API keys (“API access token”), partner tokens, and OAuth for authentication. Nango currently only supports API-key-based authentication.

• API Docs
• How to generate an API key
• OAuth related docs
• Workable API rate limits
• Web API docs (their REST API)

Contribute useful links by editing this page

Connection configuration in Nango

• Workable requires a user specific subdomain for the API base URL.

API gotchas

• To authorize a Workable Connection in Nango you need to pass both the API key and the company’s workable subdomain.
• The API base URL in Nango is set to https://{subdomain}.workable.com for future forward compatability. To call endpoints of the V3 API, prefix the endpoint with /spi/v3/, e.g. /spi/v3/candidates.

Contribute API gotchas by editing this page

Connect to Workable

Guide to connect to Workable using Nango Connect.