Skip to content
KiweelyKiweelyKiweely

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
  • Applies to Workday WQL called as an Integration System User
  • 2 min read
  • Published
  • By Kiweely
On this page

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.
Error Meaning
ErrorWCPISU is not configured for this app MeaningISU not assigned or no API client in App Manager
ErrorCreate API Client 409 MeaningStale Developer Site client still linked to the ISU name
ErrorInvalid report field MeaningAlias 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

Related guides

All guides

Let Workday check the work.

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

Get the next guide in your inbox.

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

We’ll email you once to confirm. Unsubscribe in one click from any issue.