Skip to content
Dashboard
Theme
Theme

Workday HRIS directory sync

Set up directory sync from Workday

View Markdown

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.

  1. 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.

  2. 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.

  3. 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.

  4. 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.

  5. 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

  6. 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.

  7. 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.