Publish a Workday custom report as a web service, give an integration system user access to it, and we read the report in JSON every few minutes.
The values in braces, such as {acs_url}, are specific to your connection. The setup link from the application you are connecting shows them with a copy button. The same steps appear there.
-
Create an integration system user
Section titled “Create an integration system user”Ask your Workday security administrator to create an integration system user for OhAuthCat and add it to a security group that may run the report below and see the workers you want to sync. Note its username and password.
-
Create a custom report of workers
Section titled “Create a custom report of workers”Create an advanced custom report with one row per worker and these columns, using exactly these names: employee_id, email, first_name, last_name, and optionally title, department, manager_id and active. Set active to false or leave the worker out to remove them.
-
Enable the report as a web service
Section titled “Enable the report as a web service”Turn on the option that makes the report available as a web service, and share the report with the integration system user’s security group.
-
Copy the JSON report URL
Section titled “Copy the JSON report URL”Open the report’s web service URLs and copy the JSON one. It is an https address on a workday.com or myworkday.com host and ends in format=json.
-
Enter the credentials in this setup
Section titled “Enter the credentials in this setup”Paste the report URL and enter the integration system user’s username and password. We run the report once to check them before saving them encrypted; if the check fails, nothing is saved.
Fixes:
directory_source_credentials_invalid,directory_source_unavailable -
Preview and choose the interval
Section titled “Preview and choose the interval”Select Preview to see who would be added, updated and removed, without changing anything. We read the report every 5 minutes by default; you can set any interval from 5 minutes to 24 hours.
-
Know who is synced
Section titled “Know who is synced”Every sync reads the whole report. Workers the report no longer returns, or returns as inactive, are removed from the directory, and departments become groups.
Sources
Section titled “Sources”- Concept: Reports-as-a-Service (RaaS) (Workday), read on 2026-10-30