> This page is for Agent Handler. > For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://docs.merge.dev/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.merge.dev/_mcp/server. # Workday **Authentication:** OAuth. See [Magic Link](/merge-agent-handler/features/magic-link) for the runtime auth flow, or [Application credentials](/merge-agent-handler/admin-setup/add-oauth-credentials) to bring your own OAuth app. ## Sample use cases * 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. ## Available Tools #### list\_custom\_object\_definitions List custom object definitions via customObjectDefinition/v1/definitions. Returns definitions with field schemas and metadata. Use to discover available custom object definition IDs. #### get\_custom\_object\_definition Get detailed custom object definition by ID including all field definitions, data types, and validation rules via customObjectDefinition/v1. Use list\_custom\_object\_definitions to find valid IDs. #### list\_custom\_field\_types List available custom field types via customObjectDefinition/v1/fieldTypes. Returns field type definitions that can be used when creating custom object definitions. Use to find valid field type IDs. #### get\_custom\_object\_fields Get fields for a custom object definition via customObjectDefinition/v1/definitions/\{id}/fields. #### create\_custom\_object\_definition Create a new custom object definition via customObjectDefinition/v1/definitions POST. #### update\_custom\_object\_definition Update an existing custom object definition via customObjectDefinition/v1/definitions/\{id} PUT. Only provided fields are updated. Use list\_custom\_object\_definitions to find valid IDs. #### delete\_custom\_object\_definition Delete a custom object definition permanently via customObjectDefinition/v1/definitions/\{id} DELETE. Use list\_custom\_object\_definitions to find valid IDs. #### list\_employees Retrieve a paginated list of employees via common/v1/workers. #### get\_employee Retrieve employee profile information for a specific employee ID via common/v1/workers/\{id}. #### update\_employee Update employee information via common/v1/workers/\{id} PATCH. #### get\_employee\_compensation Retrieve compensation data for a worker via compensation/v2/workers/\{id}. #### get\_employee\_benefits Retrieve eligible absence types for a worker via absenceManagement/v4/workers/\{id}/eligibleAbsenceTypes. #### request\_one\_time\_payment Request a one-time payment for a worker via compensation/v2/workers/\{id}/requestOneTimePayment POST. #### list\_organizations Retrieve a paginated list of organizations via common/v1/organizations. #### get\_organization Retrieve organization details for a specific ID via common/v1/organizations/\{id}. #### list\_supervisory\_organizations Retrieve a paginated list of supervisory organizations via common/v1/supervisoryOrganizations. #### get\_organization\_workers Retrieve workers assigned to a supervisory organization via common/v1/supervisoryOrganizations/\{id}/workers. #### list\_pay\_groups Retrieve a paginated list of pay groups via payroll/v2/payGroups. #### get\_pay\_group Get details for a specific pay group via payroll/v2/payGroups/\{id}. Returns pay group configuration, frequency, currency, and member information. Use list\_pay\_groups to find valid IDs. #### get\_pay\_group\_details Get pay group detail by ID via payroll/v2/payGroupDetails/\{id}. #### list\_worker\_pay\_slips Retrieve a paginated list of pay slips for a specific worker via common/v1/workers/\{id}/paySlips. #### get\_worker\_pay\_slip Get a specific pay slip for a worker via common/v1/workers/\{wid}/paySlips/\{id}. #### create\_payroll\_input Submit payroll input data via payroll/v2/payrollInputs POST. #### list\_payroll\_inputs Retrieve a paginated list of payroll inputs via payroll/v2/payrollInputs GET. Returns previously submitted payroll input data including earnings, deductions, and processing status. #### list\_pay\_components Retrieve available pay components (earnings codes) via payroll/v2/values/payrollInputsGroup/payComponents. #### list\_job\_postings Retrieve a paginated list of job postings via recruiting/v4/jobPostings. #### get\_job\_posting Retrieve job posting details for a specific ID via recruiting/v4/jobPostings/\{id}. #### list\_prospects Retrieve a paginated list of recruiting prospects via recruiting/v4/prospects. #### get\_prospect Retrieve prospect profile information for a specific ID via recruiting/v4/prospects/\{id}. #### create\_prospect Create a new recruiting prospect via recruiting/v4/prospects POST. #### list\_interviews Retrieve a paginated list of interviews via recruiting/v4/interviews. #### get\_interview Retrieve interview details for a specific ID via recruiting/v4/interviews/\{id}. #### submit\_interview\_feedback Submit feedback for an interview via recruiting/v4/interviews/\{id}/feedback POST. #### list\_data\_sources List WQL data sources via wql/v1/dataSources. Returns available data sources that can be queried with WQL. Use to find data source IDs for get\_data\_source and get\_data\_source\_fields. #### get\_data\_source Get a specific WQL data source by ID via wql/v1/dataSources/\{id}. Returns data source metadata including name, description, and available fields. Use list\_data\_sources to find valid IDs. #### get\_data\_source\_fields Get fields for a WQL data source via wql/v1/dataSources/\{id}/fields. Returns field names, types, and descriptions. Use list\_data\_sources to find valid data source IDs. #### execute\_wql\_query Execute a WQL query via wql/v1/data POST. #### query\_wql\_data Query WQL data via wql/v1/data GET with a query string parameter. Returns paginated structured data. Use list\_data\_sources and get\_data\_source\_fields to build valid queries. #### list\_time\_clock\_events Retrieve time clock events via timeTracking/v4/timeClockEvents. #### create\_time\_clock\_event Create a new time clock event via timeTracking/v4/timeClockEvents POST. #### update\_time\_clock\_event Update an existing time clock event via timeTracking/v4/timeClockEvents/\{id} PUT. Modify hours, time type, or notes. If update fails, check event\_id exists and entry is not locked/approved. #### delete\_time\_clock\_event Delete a time clock event via timeTracking/v4/timeClockEvents/\{id} DELETE. #### get\_worker\_time\_totals Retrieve time totals for a worker via timeTracking/v4/workers/\{id}/timeTotals. #### submit\_time\_review Submit a time review event for a worker via timeTracking/v4/workers/\{id}/timeReviewEvents POST. #### list\_workers Retrieve a paginated list of all workers via common/v1/workers. #### get\_worker Retrieve worker profile for a specific ID via common/v1/workers/\{id}. #### create\_worker Create a new worker via common/v1/workers POST. #### update\_worker Update existing worker via common/v1/workers/\{id} PATCH. #### delete\_worker Terminate a worker via common/v1/workers/\{id} DELETE. #### get\_absence\_balances Get absence/PTO balances for a worker via absenceManagement/v4/balances. Returns remaining balances across all absence plans (PTO, sick, etc). #### get\_eligible\_absence\_types Retrieve eligible absence types for a worker via absenceManagement/v4/workers//eligibleAbsenceTypes. #### get\_leave\_of\_absence Get details of a specific leave of absence via absenceManagement/v4/workers//leavesOfAbsence/. #### get\_time\_off\_entry Get details of a specific time off entry via absenceManagement/v4/workers//timeOffDetails/. #### list\_leaves\_of\_absence List leaves of absence for a worker via absenceManagement/v4/workers//leavesOfAbsence. Returns formal leave records (FMLA, parental, medical, etc). #### list\_time\_off\_entries List time off entries for a worker via absenceManagement/v4/workers//timeOffDetails. Returns PTO requests with dates, status, and hours. #### request\_time\_off Submit a time off request via absenceManagement/v4/workers//requestTimeOff POST. Creates a PTO/sick/leave request with per-day entries.