Workable

{/* 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_TOKEN is sent as the Bearer prefixed Authorization header.
  • Provider documentation: Authentication reference.

Credentials

Set these per environment. See Connect an integration.

VariableRequiredDescription
WORKABLE_API_TOKENYesWorkable API access token, generated under Settings → Integrations → Apps → Generate new token Docs.
WORKABLE_SUBDOMAINNoYour Workable account subdomain ({subdomain}.workable.com), shown in your company profile settings Docs.

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

ToolAccessDescription
List Jobs<br /><code className="reference-identifier">workable__list_jobs</code>ReadList jobs
Get Job<br /><code className="reference-identifier">workable__get_job</code>ReadGet job
List Candidates<br /><code className="reference-identifier">workable__list_candidates</code>ReadList candidates
Get Candidate<br /><code className="reference-identifier">workable__get_candidate</code>ReadGet candidate
List Members<br /><code className="reference-identifier">workable__list_members</code>ReadList members
List Stages<br /><code className="reference-identifier">workable__list_stages</code>ReadList stages
Create Candidate<br /><code className="reference-identifier">workable__create_candidate</code>WriteCreate candidate
Create Candidate Comment<br /><code className="reference-identifier">workable__create_candidate_comment</code>WriteCreate candidate comment
Move Candidate<br /><code className="reference-identifier">workable__move_candidate</code>WriteMove candidate

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.