Skip to main content
This guidance assumes you have administrative privileges for your Workday account.
Workday Report as a Service (RaaS) allows you to create custom reports and expose them as web services for integration purposes. This guide walks you through setting up an Integration System User, creating and sharing a web‑service‑enabled Advanced custom report, configuring security group permissions, and connecting it through the integration platform.

Set Up an Integration System User (Optional)

Setting up an Integration System User (ISU) is recommended but optional. You can use an existing Workday user account with appropriate permissions instead. The key requirement is having valid credentials (username and password) with access to create and manage custom reports.
1

Go to Create Integration System User

Search for and open the Create Integration System User task.
Create Integration System User
2

Enter account information

Enter a username and strong password in the Account Information section, then click OK to create the user.
Account Information

Create and View a Custom Report (Optional)

1

Go to Create Custom Report

Search and navigate to the Create Custom Report task
Accessing Report Designer
2

Configure custom report

Follow the steps below to configure the custom report:
  • Report Name: Must be unique within the tenant
  • Report Type: Select Advanced
  • Optimised for Performance: Tick this box to enhance performance
  • Data Source: Choose the appropriate data source based on the data you need (e.g. Workers for HCM reporting).
Create Custom Report
Click OK to continue.Add and configure report fields:
  • Click the + icon to add a field.
  • Select a Business Object (e.g. Worker) in the Business Object column.
  • Choose the specific field (e.g. Employee ID) in the Field column.
  • Set aliases in Column Heading Override and Column Heading Override XML Alias to ensure stable field names in API responses.
For employee data, you can include the following fields:
  • Employee_ID
  • First_Name
  • Last_Name
  • Display_Name
  • Email_Work
  • Email_Home
  • Phone_Work
  • Phone_Home
  • Job_Title
  • Hire_Date
  • Gender
  • Date_Of_Birth
  • Termination_Date
  • Company_Name
Fields and Aliases Settings
3

Configure report filters (Optional)

Add filters to narrow the result data set (e.g. Supervisory Organisation – Primary Position).
Filters Settings
4

Configure report prompts

Enable prompt display by ticking Display Prompt Values in Subtitle. Leave other settings at their defaults.
Prompts Settings
5

Configure advanced options

Tick Optimised for Performance and Enable As Web Service. Leave other advanced options unchanged.
Advanced Settings
Click OK to save the report.
6

Go to View Custom Report

Search for View Custom Report, select the report you just created, then click OK to open it.
Accessing Report Designer
7

Retrieve the Report URL

Open the three‑dot menu, select Web Service > View URLs; you will be redirected to the View URLs Web Service page.
View URLs
Right‑click the Workday XML link and copy its URL.
Copy Workday XML URL

Connecting to StackOne

Use the ISU Username, ISU Password, and Report URL to create a connection.
StackOne Connector Hub
After connecting and calling the unified List Employees endpoint, you may see:
  1. A response with all fields populated.
  2. A response with fields present but values are null.
  3. An error: The task submitted is not authorized.
  4. An error: Report not found.
Scenario 1 = successful configuration.
Scenario 2 = missing Security Group permissions for the ISU.
Scenarios 3 & 4 = insufficient report access for the ISU credentials used.
Proceed to Configure Security Group Permissions for the ISU (Required for non‑null data) and Configure Custom Report Access for the ISU (Required for report access) to resolve issues.

Configure Security Group Permissions for the ISU (Required for non‑null data)

1

Create a Security Group

Search for and open the Create Security Group task.
Search Security Group
2

Select type of Tenanted Security Group

Choose Integration System Security Group (Unconstrained) and enter a name for the Security Group.
Create Security Group
Click OK.
3

Assign the ISU to the Security Group

Select Integration System Users. Pick the ISU created earlier (or another integration user).
Add Members to Security Group
Click OK to save.
4

Go to Maintain Permissions for Security Group

Search for Maintain Permissions for Security Group and open it.
Search Domain Security Policy Permissions
Select the Security Group you created in the steps above.
Select Created Security Group
5

Configure Domain Security Policy Permissions

Set required Domain Security Policy Permissions to Get Only in the View/Modify Access column. Common Domain Security Policy Permissions are listed below:
View/Modify Access
Please note that Domain Security Policy Permissions can be customised within a Workday organisation, and this list does not account for such customisations.
Domain Security PolicyView/Modify Access
Job InformationGet Only
Person Data: Date of BirthGet Only
Person Data: EthnicityGet Only
Person Data: GenderGet Only
Person Data: Home EmailGet Only
Person Data: ID InformationGet Only
Person Data: Marital StatusGet Only
Person Data: Personal DataGet Only
Person Data: Work EmailGet Only
Depending on the fields included in your custom report, additional Domain Security Policy Permissions may be required. If you encounter null values in the API response, review and add the necessary permissions accordingly.
6

Activate security changes

Search for Activate Pending Security Policy Changes and open it.
Search to Activate Pending Permissions
Optionally add a comment, then continue.
Navigate to Activate Pending Permissions
Review the summary, tick the confirmation box, and click OK.
Confirm Permissions
You must activate security changes each time you modify Domain Security Policy Permissions; otherwise changes will not take effect.

Configure Custom Report Access for the ISU (Required for report access)

1

Open the report

Search for View Custom Report.
Search View Custom Report
Select your custom report.
Select Custom Report
2

Check current ownership

Navigate to the Share tab and view the Report Owned by value.
Default Report Owner
3

Transfer ownership (if required)

Transferring ownership revokes access from the current owner.
After transferring, ensure you reconnect in the StackOne Connector Hub using the new owner’s ISU credentials; otherwise you will encounter the The task submitted is not authorized error.
If the current owner is not the ISU you intend to use to connect with StackOne, open the three‑dot menu under Custom Report and select Transfer Ownership.
Change Report Owner
Enter the new ISU username in New Owner and click OK.
Enter New Owner
4

Grant access without transferring ownership

Granting access retains the current owner. Authorised users can access the report and connect via the StackOne Connector Hub using their ISU credentials and the Report URL.
To grant access, choose Edit under Custom Report from the three‑dot menu.
Edit Report
Three options exist under Report Definition Sharing Options; the appropriate option for controlled user access is described in this guide.
Go to the Share tab, select Share with specific authorized groups and users, choose the desired ISU in Authorized Users, then click OK.
  • Do Not Share Report Definition: Only the owner can access and retrieve data through the Report URL. If ownership changes or other ISU credentials are used, errors such as Report not found or The task submitted is not authorized may occur.
  • Share with All Authorized Users: All ISU users can access the report. Ownership should remain with the report creator; otherwise StackOne connections using other users’ credentials may encounter a Report not found error.
  • Share with Specific Authorized Groups and Users: Restrict access to selected groups/users.
    • No selection acts like Do Not Share Report Definition.
    • Selecting users allows both owner and selected ISU users to access the report (ownership must still stay with the report creator to avoid a Report not found error).
Share Tab Settings

Troubleshooting

1

Connection errors

  • Verify ISU credentials in the StackOne Connector Hub.
  • Verify the Report URL is correct and reachable.
2

Null field values

  • Add missing Domain Security Policy Permissions as described in the security configuration section.
  • Activate pending security policy changes after modifications.
  • Retry the endpoint (fields populate once permissions are effective).