Workday
Workday connector for HCM, payroll, time tracking, recruiting, custom objects, and WQL reporting.
Categories: Human Resources, HRIS, Payroll, Time Tracking, Recruiting, Workforce Management, HCM
What you can ask
- List employees with upcoming performance reviews in the next 30 days.
- Pull current PTO balances by department.
- Find employees on leave this Friday for staffing planning.
Set up
Workday needs an OAuth application from your organization before anyone can connect. An organization admin completes these steps once.
- Go to Organization > Connectors and find Workday. Click Enable, and choose which tools to allow.
- Create an OAuth application in the Workday developer portal.
- Add the Redirect URI shown in the connector settings to the application.
- Copy the application's Client ID and Client Secret into the connector, then save it.
- Each member connects their own account the first time they use it.
⚠️ Warning: Do not enter your Devs.ai or Workday login email or password in the OAuth application fields.
To use one account for the whole organization, turn on Share one connection with everyone. Every member's agents then act as that account, with exactly the access it has.
OAuth scopes used by these tools (13)
Grant the scopes for the tools you plan to allow.
Adaptive Planning for Financial PlansAdaptive Planning for the WorkforceCore CompensationCore PayrollOrganizations and RolesRecruitingStaffingSystemTalent PipelineTime Off and LeaveTime TrackingTime Tracking HubWorkday Designer
Tools
Workday offers 62 tools. Admins choose which ones agents can use. See Tool permission groups.
Read (50)
View and search information without changing it.
| Tool | What it does |
|---|---|
execute_wql_query | Execute a WQL query via wql/v1/data POST (use for queries over 2,048 characters; otherwise query_wql_data). |
get_absence_balances | Get absence/PTO balances via absenceManagement/v4/balances. |
get_custom_object_definition | Get detailed custom object definition by ID including all field definitions, data types, and validation rules via customObjectDefinition/v1. |
get_custom_object_fields | Get fields for a custom object definition via customObjectDefinition/v1/definitions/{id}/fields. |
get_data_source | Get a specific WQL data source by ID via wql/v1/dataSources/{id}. |
get_data_source_fields | Get fields for a WQL data source via wql/v1/dataSources/{id}/fields. |
get_eligible_absence_types | Retrieve eligible absence types for a worker via absenceManagement/v4/workers/{id}/eligibleAbsenceTypes. |
get_employee_compensation | Get a worker's profile from compensation/v2/workers/{id}: title, location, supervisory org. |
get_interview | Retrieve interview details for a specific ID via recruiting/v4/interviews/{id}. |
get_job_posting | Retrieve job posting details for a specific ID via recruiting/v4/jobPostings/{id}. |
get_leave_of_absence | Get details of a specific leave of absence via absenceManagement/v4/workers/{id}/leavesOfAbsence/{subId}. |
get_organization | Get an organization by ID via common/v1/organizations/{id}. |
get_organization_workers | Retrieve workers assigned to a supervisory organization via common/v1/supervisoryOrganizations/{id}/workers. |
get_pay_group | Get details for a specific pay group via payroll/v2/payGroups/{id}. |
get_pay_group_details | Get pay group detail by ID via payroll/v2/payGroupDetails/{id}. |
get_prospect | Retrieve prospect profile information for a specific ID via recruiting/v4/prospects/{id}. |
get_supervisory_organization | Get one supervisory organization via common/v1/supervisoryOrganizations/{id}, including its manager and name (and code, when the org has one). |
get_time_off_entry | Get details of a specific time off entry via absenceManagement/v4/workers/{id}/timeOffDetails/{subId}. |
get_worker | Retrieve worker profile for a specific ID via common/v1/workers/{id}. |
get_worker_pay_slip | Get a specific pay slip for a worker via common/v1/workers/{wid}/paySlips/{id}. |
get_worker_time_totals | Retrieve time totals for a worker via timeTracking/v4/workers/{id}/timeTotals. |
list_compensation_reasons | List business-process reasons (Event Classification Subcategories) via WQL, for reason_id on request_one_time_payment. compensation/v2 exposes no prompt for these, so this is the only source. |
list_countries | List the countries a prospect can be created against, via recruiting/v4/values/common/countries. |
list_custom_field_types | List available custom field types via customObjectDefinition/v1/fieldTypes. |
list_custom_object_definitions | List custom object definitions via customObjectDefinition/v1/definitions. |
list_data_sources | List WQL data sources via wql/v1/dataSources. |
list_interviews | Retrieve a paginated list of interviews via recruiting/v4/interviews. |
list_job_postings | Retrieve a paginated list of job postings via recruiting/v4/jobPostings. |
list_leaves_of_absence | List leaves of absence for a worker via absenceManagement/v4/workers/{id}/leavesOfAbsence. |
list_one_time_payment_plans | List one-time payment plans via WQL (allOne_TimePaymentPlans), for payments[].one_time_payment_plan_id on request_one_time_payment. compensation/v2 exposes no prompt for these, so this is the only source. |
list_organizations | List organizations of one type (cost centers, divisions, companies) via common/v1/organizations. type_filter is required: Workday returns zero rows without it. |
list_pay_component_calculations | List pay component related calculations via WQL, the only reachable source for input_details[].type_id on create_payroll_input - payroll/v2 exposes no prompt for these. |
list_pay_components | Retrieve all available pay components (earnings codes) via payroll/v2/values/payrollInputsGroup/payComponents. |
list_pay_groups | Retrieve a paginated list of pay groups via payroll/v2/payGroups. |
list_payroll_inputs | Retrieve a paginated list of payroll inputs via payroll/v2/payrollInputs GET. |
list_project_plan_tasks | List the project plan tasks a worker can bill a punch to on a date, via timeTracking/v4/values/timeTypes/projectPlanTasks. |
list_security_domains | List Workday security domains via WQL (allDomains), for the domains field on create_custom_object_definition and update_custom_object_definition. customObjectDefinition/v1 has no prompt for these and GET on a definition never returns its domains, so this is the only source. |
list_supervisory_organizations | Retrieve a paginated list of supervisory organizations via common/v1/supervisoryOrganizations. |
list_time_clock_events | Retrieve time clock events via timeTracking/v4/timeClockEvents. |
list_time_entry_codes | List the time entry codes a worker is eligible for on a date, via timeTracking/v4/values/timeTypes/timeEntryCodes. |
list_time_off_entries | List time off entries for a worker via absenceManagement/v4/workers/{id}/timeOffDetails. |
list_time_tracking_projects | List the projects a worker can bill a punch to on a date, via timeTracking/v4/values/timeTypes/projects. |
list_worker_direct_reports | List a manager's direct reports via common/v1/workers/{id}/directReports. |
list_worker_pay_slips | Retrieve a paginated list of pay slips for a specific worker via common/v1/workers/{id}/paySlips. |
list_worker_positions | List a worker's positions, via timeTracking/v4/values/timeValues/positions. |
list_worker_time_zones | List the time zones a worker can punch in, via timeTracking/v4/values/timeValues/workerTimeZone. |
list_workers | Retrieve a paginated list of workers via common/v1/workers. |
query_wql_data | Query WQL data via wql/v1/data GET with a query string parameter. |
search_pay_components | Find pay components for one payroll country via WQL, for pay_component_id on create_payroll_input. |
validate_credential | Validate Workday credentials. |
Write (7)
Create or send data.
| Tool | What it does |
|---|---|
create_custom_object_definition | Create a custom object definition via customObjectDefinition/v1/definitions POST. |
create_payroll_input | Submit one payroll input via payroll/v2/payrollInputs POST for supplemental earnings, deductions, bonuses or retro corrections. |
create_prospect | Create a recruiting prospect via recruiting/v4/prospects POST. |
create_time_clock_event | Record one punch via timeTracking/v4/timeClockEvents POST; post an In and an Out to bracket a shift. |
request_one_time_payment | Request a one-time payment for a worker via compensation/v2/workers/{id}/requestOneTimePayment POST, the only compensation write in the Workday REST API. compensation/v2 has no prompt endpoints, so source every WID first: position_id from list_worker_positions, reason_id from list_compensation_reasons, and each payments[].one_time_payment_plan_id from list_one_time_payment_plans. |
request_time_off | Submit a time off request via absenceManagement/v4/workers/{id}/requestTimeOff POST. |
submit_interview_feedback | Submit feedback for an interview via recruiting/v4/interviews/{id}/feedback POST. |
Delete or overwrite (5)
Remove or replace existing data.
| Tool | What it does |
|---|---|
delete_custom_object_definition | Delete a custom object definition permanently via customObjectDefinition/v1/definitions/{id} DELETE. |
delete_time_clock_event | Delete a time clock event via timeTracking/v4/timeClockEvents/{id} DELETE. |
submit_time_review | Submit a worker's time for approval via timeTracking/v4/workers/{id}/timeReviewEvents POST. |
update_custom_object_definition | Replace a custom object definition via customObjectDefinition/v1/definitions/{id} PUT. |
update_time_clock_event | Update a time clock event via timeTracking/v4/timeClockEvents/{id}. |