Source candidates via the Workable API

Steps

1. 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
2. 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
3. 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
4. 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
5. 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
6. Subscribe to candidate webhooks via the Workable partner settings to receive real-time notifications when candidates are created or their stages change