Skip to main content

​
At a glance

  • Availability: Experimental (how to enable).
  • Authentication: API key.
  • Connection: The key from WORKABLE_API_TOKEN is sent as the Bearer prefixed Authorization header.
  • Provider documentation: Authentication reference.

​
Credentials

Set these per environment. See Connect an integration.

​
Setup

  1. 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.
  2. 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.
  3. Find your subdomain: Your account subdomain is the {subdomain} part of {subdomain}.workable.com and is shown on your company profile settings page.
  4. 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)
Provider API reference.

​
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.