> This page is for Workforce. > 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.