- Category: human resources
- Auth: OAUTH2, API_KEY
- Composio-managed OAuth available? No
- Tools: 37
- Triggers: 0
- Slug:
WORKABLE - Version: 20261101_00
Tools
Create Employee
Create Employee
WORKABLE_CREATE_EMPLOYEETool to create an employee in your Workable account. Use when adding a new hire to employee management system. Employee can be created in draft state (unpublished) or published state (active). Requires w_employees scope.Input Parameters
Output
Delete Department
Delete Department
Delete Subscription
Delete Subscription
Get Account
Get Account
Get Accounts
Get Accounts
WORKABLE_GET_ACCOUNTSRetrieves all Workable accounts (organizations) accessible to the authenticated user. Returns account details including ID, name, subdomain, description, summary, and website URL. Use this action to discover which Workable accounts you have access to, or to obtain account identifiers needed for other API operations. Requires ‘r_jobs’ scope.Output
Get Background Check Packages
Get Background Check Packages
WORKABLE_GET_BACKGROUND_CHECK_PACKAGESRetrieve background check packages for a specified provider. An HTTP 404 is returned as an empty package list, so an empty result does not necessarily establish that no packages are available.Input Parameters
Output
Get Background Check Providers
Get Background Check Providers
Get Candidate
Get Candidate
Get Candidates
Get Candidates
WORKABLE_GET_CANDIDATESRetrieve candidates across jobs, with optional job, stage, email, and creation or update date filters. Results include candidate details and may include a next-page URL; the limit sets page size up to 100, but this action does not accept a page cursor.Input Parameters
Output
Get Employee
Get Employee
WORKABLE_GET_EMPLOYEETool to retrieve detailed information for a specific employee by ID. Use when you need complete employee data including personal details, contact info, employment history, and more. Requires r_employees scope and may need member_id parameter for account-level tokens.Input Parameters
Output
Get Events
Get Events
WORKABLE_GET_EVENTSRetrieve a collection of scheduled events (calls, interviews, meetings) from the Workable account. Supports filtering by event type, date range, candidate, job, or team member. Use pagination parameters (limit, since_id, max_id) for large result sets. By default, cancelled events are excluded unless explicitly included.Input Parameters
Output
Get Job
Get Job
Get Job Activities
Get Job Activities
Get Jobs
Get Jobs
WORKABLE_GET_JOBSRetrieve a paginated list of Workable account jobs, with details such as title, state, department, location, and salary. Filter by state or creation and update dates.Input Parameters
Output
Get Legal Entities
Get Legal Entities
Get Members
Get Members
WORKABLE_GET_MEMBERSRetrieve a paginated list of Workable account members with their roles and permissions. This action fetches team members from your Workable account, including admins, standard users, reviewers, and inactive members. You can filter by role, email, name, or status, and paginate through results. Use this to list collaborators, verify member access levels, or find specific team members by email or name.Input Parameters
Output
Get recruiters
Get recruiters
WORKABLE_GET_RECRUITERSRetrieves external recruiters from your Workable account. Returns all external recruiters by default, or filter by job shortcode to get recruiters collaborating on a specific job. Requires r_jobs scope.Input Parameters
Output
Get Requisitions
Get Requisitions
Get Stages
Get Stages
Get Subscriptions
Get Subscriptions
WORKABLE_GET_SUBSCRIPTIONSRetrieves all webhook subscriptions configured in your Workable account. Use this tool to: - List all active webhook subscriptions that receive event notifications - Verify which events your webhooks are listening to - Check the target URLs and filters configured for each subscription - Audit your webhook configuration Requires ‘r_candidates’ or ‘r_employees’ scope. No parameters needed.Output
List Candidate Activities
List Candidate Activities
List Custom Attributes
List Custom Attributes
WORKABLE_LIST_CUSTOM_ATTRIBUTESTool to retrieve all custom attributes configured in the Workable account. Returns attribute configuration including ID, type, enabled status, labels, and hints. Use this action to discover available custom attributes before creating or updating candidates, jobs, or other entities that support custom fields. Requires ‘r_jobs’ scope.Output
List Departments
List Departments
List Disqualification Reasons
List Disqualification Reasons
List Employee Fields
List Employee Fields
WORKABLE_LIST_EMPLOYEE_FIELDSTool to retrieve a collection of your account’s employee field definitions. Use when you need to understand available employee data fields before creating or updating employee records.Input Parameters
Output
List Employees
List Employees
WORKABLE_LIST_EMPLOYEESRetrieve a collection of account employees, with search by name or email, ordering by division or department, and pagination via limit and offset. Requires the r_employees scope.Input Parameters
Output
List Job Questions
List Job Questions
List Permission Sets
List Permission Sets
List Public Jobs
List Public Jobs
List Public Locations
List Public Locations
WORKABLE_LIST_PUBLIC_LOCATIONSTool to retrieve a collection of locations where a Workable account has public job postings. Use when you need to discover which geographic locations have available positions for a specific account. No authentication required.Input Parameters
Output
List Time Off Balances
List Time Off Balances
WORKABLE_LIST_TIMEOFF_BALANCESRetrieves all time off balances for an employee across all time off categories. Returns detailed balance information including available units, used units, carry-over amounts, and tracking units (days/hours). Use this to check remaining vacation days, sick leave, or other time off allowances for an employee. When using account-level token, employee_id must be provided; employee-level tokens automatically use the authenticated employee’s balances.Input Parameters
Output
List Time Off Categories
List Time Off Categories
List Work Schedules
List Work Schedules
Update Background Check Status
Update Background Check Status
WORKABLE_POST_BACKGROUND_CHECKUpdates the status and results of an existing background check in a candidate’s timeline. This tool is designed for background check providers to push status updates (pending, consented, completed, declined, expired) and results back to Workable after initiating a background check. Use this action when: - A candidate has consented to or declined a background check request - Background check results are complete and need to be injected into the candidate’s timeline - The status of an ongoing background check has changed - Attaching final reports and structured results to a completed check Prerequisites: Requires a valid background_check_id from an existing background check request that was previously created through Workable’s background check provider integration. Note: Uses PUT request to /checks/{background_check_id} endpoint (despite the ‘Post’ naming).Input Parameters
Output
Merge Department
Merge Department
WORKABLE_POST_DEPARTMENT_MERGEMerge a department into another using their IDs. The force flag defaults to true and is sent with the merge request unless explicitly set to null.Input Parameters
Output
Create Department
Create Department
Enable Member
Enable Member
Invite Member
Invite Member
WORKABLE_POST_MEMBERS_INVITETool to invite a member to your Workable account. Use when sending an invitation email.Input Parameters
Output
Update Department
Update Department
Update Member
Update Member
WORKABLE_PUT_MEMBERSUpdates a Workable account member’s details including roles, name, headline, email, and collaboration rules. Requires member ID and roles array. Use this to modify existing member information such as changing permissions, updating contact details, or adjusting collaboration settings.Input Parameters
Output
Update Employee
Update Employee