Query Workday business objects with Workday Query Language (WQL) via a registered API client
domain: hr-payroll · 5 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗
Steps
Register an API client for your tenant using the Register API Client for Integrations task; when configuring it for WQL, select System from the Scope (Functional Areas) prompt
When setting up the refresh token, select a Workday account with report-execution access, since WQL calls run under that account's access
Build a query manually using WQL's SQL-like syntax against Workday data sources and fields, or use the "Convert report to WQL" option on an existing report as a starting point
Call the WQL REST API endpoint with the query to retrieve filtered, sorted, or aggregated data, paging through results as needed
Confirm the requesting account has access to the Workday Query Language domain in the System functional area, or calls will be rejected
Known gotchas
You do not need to register an API client when calling WQL from inside a Workday Extend or Orchestration app - only for external systems
WQL results are paginated, so an integration must loop through pages rather than expecting a single response
Access to the WQL domain is a distinct security-group grant from access to the underlying data sources referenced in a query - both are required
Give your agent this knowledge — and 15,500+ more routes
One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp
Need this verified for your stack — or a route we don't have yet?