Skip to main content

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.

  1. Go to Organization > Connectors and find Workday. Click Enable, and choose which tools to allow.
  2. Create an OAuth application in the Workday developer portal.
  3. Add the Redirect URI shown in the connector settings to the application.
  4. Copy the application's Client ID and Client Secret into the connector, then save it.
  5. 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 Plans
  • Adaptive Planning for the Workforce
  • Core Compensation
  • Core Payroll
  • Organizations and Roles
  • Recruiting
  • Staffing
  • System
  • Talent Pipeline
  • Time Off and Leave
  • Time Tracking
  • Time Tracking Hub
  • Workday 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.

ToolWhat it does
execute_wql_queryExecute a WQL query via wql/v1/data POST (use for queries over 2,048 characters; otherwise query_wql_data).
get_absence_balancesGet absence/PTO balances via absenceManagement/v4/balances.
get_custom_object_definitionGet detailed custom object definition by ID including all field definitions, data types, and validation rules via customObjectDefinition/v1.
get_custom_object_fieldsGet fields for a custom object definition via customObjectDefinition/v1/definitions/{id}/fields.
get_data_sourceGet a specific WQL data source by ID via wql/v1/dataSources/{id}.
get_data_source_fieldsGet fields for a WQL data source via wql/v1/dataSources/{id}/fields.
get_eligible_absence_typesRetrieve eligible absence types for a worker via absenceManagement/v4/workers/{id}/eligibleAbsenceTypes.
get_employee_compensationGet a worker's profile from compensation/v2/workers/{id}: title, location, supervisory org.
get_interviewRetrieve interview details for a specific ID via recruiting/v4/interviews/{id}.
get_job_postingRetrieve job posting details for a specific ID via recruiting/v4/jobPostings/{id}.
get_leave_of_absenceGet details of a specific leave of absence via absenceManagement/v4/workers/{id}/leavesOfAbsence/{subId}.
get_organizationGet an organization by ID via common/v1/organizations/{id}.
get_organization_workersRetrieve workers assigned to a supervisory organization via common/v1/supervisoryOrganizations/{id}/workers.
get_pay_groupGet details for a specific pay group via payroll/v2/payGroups/{id}.
get_pay_group_detailsGet pay group detail by ID via payroll/v2/payGroupDetails/{id}.
get_prospectRetrieve prospect profile information for a specific ID via recruiting/v4/prospects/{id}.
get_supervisory_organizationGet one supervisory organization via common/v1/supervisoryOrganizations/{id}, including its manager and name (and code, when the org has one).
get_time_off_entryGet details of a specific time off entry via absenceManagement/v4/workers/{id}/timeOffDetails/{subId}.
get_workerRetrieve worker profile for a specific ID via common/v1/workers/{id}.
get_worker_pay_slipGet a specific pay slip for a worker via common/v1/workers/{wid}/paySlips/{id}.
get_worker_time_totalsRetrieve time totals for a worker via timeTracking/v4/workers/{id}/timeTotals.
list_compensation_reasonsList 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_countriesList the countries a prospect can be created against, via recruiting/v4/values/common/countries.
list_custom_field_typesList available custom field types via customObjectDefinition/v1/fieldTypes.
list_custom_object_definitionsList custom object definitions via customObjectDefinition/v1/definitions.
list_data_sourcesList WQL data sources via wql/v1/dataSources.
list_interviewsRetrieve a paginated list of interviews via recruiting/v4/interviews.
list_job_postingsRetrieve a paginated list of job postings via recruiting/v4/jobPostings.
list_leaves_of_absenceList leaves of absence for a worker via absenceManagement/v4/workers/{id}/leavesOfAbsence.
list_one_time_payment_plansList 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_organizationsList 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_calculationsList 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_componentsRetrieve all available pay components (earnings codes) via payroll/v2/values/payrollInputsGroup/payComponents.
list_pay_groupsRetrieve a paginated list of pay groups via payroll/v2/payGroups.
list_payroll_inputsRetrieve a paginated list of payroll inputs via payroll/v2/payrollInputs GET.
list_project_plan_tasksList the project plan tasks a worker can bill a punch to on a date, via timeTracking/v4/values/timeTypes/projectPlanTasks.
list_security_domainsList 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_organizationsRetrieve a paginated list of supervisory organizations via common/v1/supervisoryOrganizations.
list_time_clock_eventsRetrieve time clock events via timeTracking/v4/timeClockEvents.
list_time_entry_codesList the time entry codes a worker is eligible for on a date, via timeTracking/v4/values/timeTypes/timeEntryCodes.
list_time_off_entriesList time off entries for a worker via absenceManagement/v4/workers/{id}/timeOffDetails.
list_time_tracking_projectsList the projects a worker can bill a punch to on a date, via timeTracking/v4/values/timeTypes/projects.
list_worker_direct_reportsList a manager's direct reports via common/v1/workers/{id}/directReports.
list_worker_pay_slipsRetrieve a paginated list of pay slips for a specific worker via common/v1/workers/{id}/paySlips.
list_worker_positionsList a worker's positions, via timeTracking/v4/values/timeValues/positions.
list_worker_time_zonesList the time zones a worker can punch in, via timeTracking/v4/values/timeValues/workerTimeZone.
list_workersRetrieve a paginated list of workers via common/v1/workers.
query_wql_dataQuery WQL data via wql/v1/data GET with a query string parameter.
search_pay_componentsFind pay components for one payroll country via WQL, for pay_component_id on create_payroll_input.
validate_credentialValidate Workday credentials.

Write (7)​

Create or send data.

ToolWhat it does
create_custom_object_definitionCreate a custom object definition via customObjectDefinition/v1/definitions POST.
create_payroll_inputSubmit one payroll input via payroll/v2/payrollInputs POST for supplemental earnings, deductions, bonuses or retro corrections.
create_prospectCreate a recruiting prospect via recruiting/v4/prospects POST.
create_time_clock_eventRecord one punch via timeTracking/v4/timeClockEvents POST; post an In and an Out to bracket a shift.
request_one_time_paymentRequest 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_offSubmit a time off request via absenceManagement/v4/workers/{id}/requestTimeOff POST.
submit_interview_feedbackSubmit feedback for an interview via recruiting/v4/interviews/{id}/feedback POST.

Delete or overwrite (5)​

Remove or replace existing data.

ToolWhat it does
delete_custom_object_definitionDelete a custom object definition permanently via customObjectDefinition/v1/definitions/{id} DELETE.
delete_time_clock_eventDelete a time clock event via timeTracking/v4/timeClockEvents/{id} DELETE.
submit_time_reviewSubmit a worker's time for approval via timeTracking/v4/workers/{id}/timeReviewEvents POST.
update_custom_object_definitionReplace a custom object definition via customObjectDefinition/v1/definitions/{id} PUT.
update_time_clock_eventUpdate a time clock event via timeTracking/v4/timeClockEvents/{id}.
⌘J