--- title: Workable API Integration on Truto slug: workable category: ATS canonical: "https://truto.one/integrations/detail/workable/" --- # Workable API Integration on Truto **Category:** ATS **Status:** Generally available ## Unified APIs ### Unified HRIS API - **Employees** — Represents an employee in HRIS - **Fields** — Represent the fields for various entities in the company - **Groups** — Groups represent the groups for an Employee - **Timeoff Balances** — Represent the time off balances for an Employee - **Timeoff Requests** — Represent the time off requests for an Employee - **Timeoff Types** — Represent the time off types in a company ### Unified ATS API - **Activities** — The activity on a candidate performed by a user. - **Applications** — The applications represent an application for a job. - **Attachments** — The attachments represent an attachment for a candidate. - **Candidates** — The candidates represent a candidate. - **Departments** — The departments represent a department. - **Job Interview Stages** — The job interview stages represent a job interview stage. - **Jobs** — The jobs represent a job. - **Users** — The users represent a user. ## How it works 1. **Link your customer's Workable account.** Use Truto's frontend SDK; we handle every OAuth and API key flow so you don't need to create the OAuth app. 2. **Authentication is automatic.** Truto refreshes tokens, stores credentials securely, and injects them into every API request. 3. **Call Truto's API to reach Workable.** The Proxy API is a 1-to-1 mapping of the Workable API. 4. **Get a unified response format.** Every response uses a single shape, with cursor-based pagination and data in the `result` field. ## Use cases - **Automate candidate assessments from Workable pipeline stages** — Assessment and testing platforms can detect when a Workable candidate enters a specific interview stage, automatically trigger evaluations, and write scores and reports back into the candidate's profile — keeping recruiters inside Workable. - **Streamline background checks with pre-filled candidate data** — Background screening SaaS companies can pull candidate details like name, email, and address from Workable via Truto's Unified ATS API to auto-populate consent forms, then push clearance status and report links back as activities on the candidate timeline. - **Bridge the ATS-to-payroll gap when candidates are hired** — Payroll, EOR, and onboarding platforms can listen for hired candidates in Workable, pull their full profile and attachments (like signed offer letters), and auto-generate employment contracts — eliminating double data entry between recruiting and HR ops. - **Sync Workable's employee directory for IT provisioning and compliance** — IT management and access governance tools can continuously read employees and departments from Workable's HRIS module via Truto's Unified HRIS API to auto-provision software accounts and enforce security policies for new hires. - **Enrich workforce analytics with real-time hiring and HR data** — People analytics and workforce planning platforms can pull jobs, applications, interview stages, employees, and time-off data from Workable to give HR leaders a unified view of their talent pipeline and headcount. ## What you can build - **Automated assessment result write-back** — Push test scores as Activities and upload detailed PDF reports as Attachments directly to a Workable candidate's profile after an assessment is completed. - **Hired-candidate onboarding sync** — Detect newly hired candidates via their application status, pull their full profile and custom field data, and feed it into your onboarding or payroll workflow automatically. - **Real-time employee directory sync** — Continuously import active Employees, Departments, and Groups from Workable's HRIS module to keep your product's user roster and org chart up to date. - **Interview stage-aware workflow triggers** — Map Workable's Job Interview Stages to actions in your product — like initiating a background check, scheduling an interview, or sending a skills test — based on where a candidate sits in the pipeline. - **Time-off visibility dashboard** — Pull Timeoff Requests, Timeoff Balances, and Timeoff Types from Workable to surface leave data inside your workforce management or payroll product. - **Candidate data pre-fill for external workflows** — Fetch Candidate and Application data — including custom application question answers — to auto-populate forms in your product, reducing manual entry for end users. ## FAQs ### Which Truto Unified APIs are available for Workable? Workable is supported through both the Unified ATS API (Activities, Applications, Attachments, Candidates, Departments, Job Interview Stages, Jobs, Users) and the Unified HRIS API (Employees, Fields, Groups, Timeoff Balances, Timeoff Requests, Timeoff Types). Additional tools beyond these unified models can be built on request. ### What authentication method does the Workable integration use? Workable supports OAuth 2.0 for third-party integrations. Truto handles the full OAuth flow, token storage, and refresh so your team doesn't need to manage credentials or deal with token expiry. ### Can I write data back to Workable, or is it read-only? Workable's API supports both reads and writes. Through Truto's Unified ATS API you can post Activities (comments, notes, links) and upload Attachments to candidate profiles, as well as read Jobs, Candidates, Applications, and other resources. The exact write operations available depend on the unified model — contact Truto for specifics on update and create support. ### How does Workable identify jobs and pipeline stages in its API? Workable uses unique shortcodes to identify jobs and pipeline stages rather than simple numeric IDs. Truto normalizes these identifiers within the Unified ATS API so you can work with Jobs and Job Interview Stages consistently across ATS providers. ### Does the integration support custom fields and application question answers? Yes. The Unified HRIS API exposes a Fields resource, and Workable's candidate data includes answers to custom application questions. This lets you access company-specific data points like salary expectations or work authorization status. ### What if I need a Workable API capability that isn't covered by the Unified APIs? Truto builds additional tools and proxy endpoints on request. If you need access to a Workable-specific endpoint or data model not yet in the unified layer, reach out to the Truto team and they can add support for your use case.