---
title: "Why does WQL return 403 permission denied S22 for an ISU?"
description: "S22 means the ISU lacks permission—usually the Workday Query Language domain or a data-source domain. Grant access, activate security, rerun."
url: https://kiweely.com/guides/workday-wql-403-s22-as-isu
---

# Why does WQL return 403 permission denied S22 for an ISU?

WQL 403 with S22 means the ISU lacks permission—usually the Workday Query Language domain or a data-source domain. Grant access on the ISSG, activate security, and rerun as the ISU.

-   **Checked** against Workday on November 17
-   Applies to **Workday WQL called as an Integration System User**
-   2 min read
-   Published November 17
-   By Kiweely

WQL that returns **permission denied** with code **S22** for an Integration System User means Workday authenticated the caller and then refused the query. The usual gap is the **Workday Query Language** domain, the domains behind the data source and fields, or both.

## What Workday requires for WQL

Workday’s WQL concept states:

-   You need access to the **Workday Query Language** domain in the System functional area.
-   You can only view and use data sources and fields you have security access to inside a query.
-   External callers register an API client with **System** in Scope (Functional Areas). Extend and Orchestration apps do not need a separate client registration for WQL inside the app, but the ISU that runs the query still needs domains.

Creating ISUs for apps requires an Integration System Security Group (Unconstrained) with View/Modify (and Get/Put where SOAP is involved) on every domain the app calls. After changes, run **Activate Pending Security Policy Changes**.

Audience Builder’s invalid-field troubleshooting also notes that an ISSG or ISU needs **Get** access on domains for fields used when converting or running WQL-related report paths.

## Fix steps for an orchestration or app ISU

1.  Confirm the failing call authenticates as the expected ISU (username and API client in the log).
2.  Add the **Workday Query Language** domain (System) to the ISU’s integration system security group.
3.  Add domains for every data source and returned field in the query—including reference fields such as worker data when selected.
4.  Run **Activate Pending Security Policy Changes**.
5.  Rerun the same query as the ISU. A clean run as your admin user does not prove the ISU is complete.
6.  If it still returns S22, open a Workday case with the request id from the log.

## Related failures to keep separate

| Error | Meaning |
| --- | --- |
| WCPISU is not configured for this app | ISU not assigned or no API client in App Manager |
| Create API Client 409 | Stale Developer Site client still linked to the ISU name |
| Invalid report field | Alias or field security for a specific field, after WQL domain access exists |

Kiweely Vine can help you trace ISU domain gaps on a connected tenant with consent. Domain grants still happen in Workday security administration.

## Frequently asked questions

### What does S22 mean on a WQL response?

Workday’s REST error samples use codes such as S21 on detail objects. S22 in a permission-denied WQL or orchestration error is treated as permission denied: the user’s security policies do not allow the request.

### Is the Workday Query Language domain enough by itself?

No. You also need access to each data source and field the query uses. WQL only returns data the processing account can see.

### Do API client scopes replace domain grants for an ISU?

No. Registering a client with System scope enables WQL for external callers, but the refresh-token account or ISU still needs the domain permissions.

## Sources checked

-   [Concept: Workday Query Language (WQL)](https://doc.workday.com/admin-guide/en-us/reporting-and-analytics/custom-reports-and-analytics/workday-query-language-wql-/aht1611188422513.html)
-   [Create Integration System Users for Apps](https://developer.workday.com/documentation/GUID-f8d46604-e156-492f-a324-62ed2f6496f7)
-   [responseErrorDetail](https://developer.workday.com/documentation/lgo1595000847400/responseErrorDetail)
-   [Troubleshooting: Invalid Report Field in Audience Builder](https://doc.workday.com/admin-guide/en-us/manage-workday/collaboration/engagement-builder/troubleshooting--invalid-report-field-in-audience-.html)

## Related guides

[All guides](https://kiweely.com/guides)

-   [### How do I fix “WCPISU is not configured” on an Extend orchestration? WCPISU is not configured means the ISU is missing from App Manager or has no API client. Assign the ISU, create the client, then finish orchestration credentials. Prefer simplified ISU for new apps.](https://kiweely.com/guides/workday-extend-wcpisu-not-configured-error)
-   [### “Permission Denied (S22)” in a business-process-triggered orchestration S22 is Workday’s 403 Permission Denied: the request was understood but the user it ran as lacks the security for it. In a business process orchestration, first find that user (the ISU, the service step’s run-as user or the launch user), then grant the domain the endpoint is secured by.](https://kiweely.com/guides/workday-bp-orchestration-permission-denied-s22)
-   [### Workday ISU or API client 401, invalid\_client, invalid\_grant These errors usually blame the token, but the real cause is the ISU’s own account, its security group’s activation, or the wrong client task — not a corrupted credential.](https://kiweely.com/guides/workday-isu-authentication-errors)
-   [### Why does my Workday WQL query fail? The exact error messages and how to fix each one Workday has no WQL message worded ‘instance set invalid for prompt’. A rejected prompt value returns ‘Invalid Parameter Values for parameter’ or ‘does not meet the restrictions defined for this field’. This page quotes each common error as Workday returned it, with the fix.](https://kiweely.com/guides/wql-error-messages)

### More guides on WQL

[All 31 guides](https://kiweely.com/guides#wql)

-   [Why does Convert Report to WQL break after a field rename?](https://kiweely.com/guides/workday-convert-report-to-wql-after-field-rename)
-   [Why does Convert Report to WQL say this field is missing an adhoc alias?](https://kiweely.com/guides/convert-report-to-wql-adhoc-alias)
-   [How do I build a Workday integration inventory report with every integration system, its template, schedule, last run and owner?](https://kiweely.com/guides/workday-integration-inventory-report-wql)
-   [Retrieving Eligible Absence Plans and Live Balances for a Worker via Workday APIs](https://kiweely.com/guides/workday-absence-balances-api-eligible-plans-for-worker)
-   [Querying the Workday Worker Directory, Supervisory Hierarchy, and Cost Centers with WQL](https://kiweely.com/guides/workday-worker-directory-org-chart-search-fields-wql)
-   [Querying Open Job Requisitions and Supervisory Org Headcount via Workday Staffing APIs](https://kiweely.com/guides/workday-staffing-api-job-requisitions-open-positions-managers)
-   [Finding Unsubmitted Workday Time Blocks and Project Hours with WQL](https://kiweely.com/guides/workday-project-time-tracking-unsubmitted-hours-wql)
-   [Querying Pending Workday My Tasks and Inbox Approvals via API and WQL](https://kiweely.com/guides/workday-inbox-my-tasks-awaiting-action-rest-wql)

### From the blog on WQL

[All posts](https://kiweely.com/blog)

-   [Answering Executive Span-of-Control and Headcount Questions Live from Workday](https://kiweely.com/blog/executive-org-span-of-control-attrition-questions-live-workday)
-   [Build vs. Buy a Workday MCP Server: OAuth 2.1, SOAP, WQL, and Twice-Yearly Releases](https://kiweely.com/blog/build-vs-buy-workday-mcp-server-engineering-cost)
-   [What happens after ChatGPT writes your WQL query](https://kiweely.com/blog/after-chatgpt-writes-your-wql)

## Let Workday check the work.

Kiweely writes WQL and builds orchestrations in your own tenant, and Workday, not Kiweely, says whether they passed.

[Start for free](https://kiweely.com/download) [See how it works](https://kiweely.com/vine/how-it-works)

## Get the next guide in your inbox.

One email a month with new guides and one Extend tip. Nothing else.
