{/* Generated by scripts/generate-integration-catalog.mjs. Do not edit by hand. */}
At a glance
- Availability: Experimental (how to enable).
- Authentication: API key.
- Connection: The key from
WORKABLE_API_TOKENis sent as theBearerprefixedAuthorizationheader. - Provider documentation: Authentication reference.
Credentials
Set these per environment. See Connect an integration.
Setup
- Get a Workable account: Sign up at https://www.workable.com - a 15-day free trial account is enough for testing the API against your own data.
- Generate an access token: In Workable, open the top-right dropdown menu → Integrations, then click 'Generate new token'. Select the scopes you need (r_jobs and r_candidates for reads; w_candidates for comments and stage moves). The token is shown only once - copy it immediately.
- Find your subdomain: Your account subdomain is the {subdomain} part of {subdomain}.workable.com and is shown on your company profile settings page.
- Store the credentials: Add WORKABLE_API_TOKEN=<your token> and WORKABLE_SUBDOMAIN=<your subdomain> to your .env file. Requests go to https://{subdomain}.workable.com/spi/v3 with an Authorization: Bearer header.
Provider notes
- Tokens are scoped at generation time - writes need w_candidates (comments also accept w_comments)
- Revoking a token breaks every script using it; generate a new one and update all consumers
- List endpoints paginate via the paging.next URL and since_id cursors (max 100 per page)
Tools
Verify the connection
Call a read tool such as workable__list_jobs with arguments for your account. Confirm that the result comes from the intended account or workspace before enabling write tools.