Authenticate using a Bearer token; generate an API access token from the Workable integrations settings and include it as 'Bearer your-access-token' in the Authorization header on all requests to https://{subdomain}.workable.com/spi/v3
To create a new sourced candidate against a specific job, send POST /jobs/{shortcode}/candidates with a JSON body containing the candidate's name, email, and optionally headline, summary, phone, and social profile URLs; set 'sourced': true (or omit the field, which defaults to sourced behavior) to prevent the candidate from receiving an application confirmation email
To add a candidate to the account-level talent pool without associating them with a specific job, use POST /talent_pool/candidates with the same candidate body structure
To retrieve candidates for a job, send GET /jobs/{shortcode}/candidates with the required scope r_candidates; default page size is 50, maximum is 100 — paginate using the since_id cursor parameter
To retrieve all candidates across all jobs, call GET /candidates; apply query parameters such as email to look up a specific candidate or stage to filter by pipeline stage
Subscribe to candidate webhooks via the Workable partner settings to receive real-time notifications when candidates are created or their stages change
Known gotchas
There is no account-level candidate creation endpoint independent of a job; every POST to create a candidate must be scoped to a job shortcode or the talent pool — there is no generic /candidates POST
The subdomain in the base URL is the Workable account subdomain (e.g., mycompany.workable.com); using the wrong subdomain will return a 404 — confirm the exact subdomain with the account owner
Sourced candidates (sourced: true) do not receive notification emails; applied candidates (sourced: false) do receive a thank-you email — set this flag deliberately based on how the candidate entered your pipeline
Give your agent this knowledge — and 200+ more routes
One MCP install gives any agent live access to the full route map, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp