Workday Directory Sync
Learn about syncing your user list with Workday
Introduction
This guide outlines how to synchronize your application's Workday directories.
To synchronize an Enterprise's users and groups provisioned for your application, you'll need the following information from the Enterprise:
- The Workday Custom Report JSON endpoint
- The Workday Custom Group Report JSON endpoint
- Username for accessing the Custom Report endpoint
- Password for accessing the Custom Report endpoint
1
It's recommended that the Enterprise creates an Integration System User within Workday. The Integration System User will be used to access Custom Reports.

If at the end of all this, everything works as expected but fields are missing from the Report, ensure that the user created has access to access to the fields.

2
The Enterprise will need to create two Custom Reports for WorkOS to use. The first Custom Report will be used for syncing User information. The second report will be used for syncing Group information.
When creating the report, make sure to select the Advanced report type and to have the Enable as Web Service checkbox checked off.

3
WorkOS looks for the following information in the User Report, all of which can be properly mapped later on so no need to worry about naming or having a column for each field:
- Unique ID
- Username
- First Name
- Last Name
- Group Name
Along the same lines as the User Report, WorkOS looks for the following information in the Group Report:
- Group Name
5
Now that the Report itself is setup and access to it had been configured, the Enterprise will need to get the RaaS endpoint. The page with the endpoints can be found under Actions-> Web Service -> View URLs.

Once on the URLs page, the one that WorkOS will need is listed under the JSON section.
