# Workday HRIS directory sync

<!-- Generated by scripts/generate.ts. Do not edit. -->

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.

:::caution[Verification]
Not yet verified on a real Workday tenant. It was written from the public Workday documentation, so labels in the admin console may differ slightly.
:::

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.

## Steps

<ol class="idp-steps">

<li class="idp-step">

<a id="isu"></a>

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

:::caution[Labels not confirmed in step 1]
Workday's public developer documentation does not show the task names for creating an integration system user and its security group; ask your Workday security administrator.
:::

</li>

<li class="idp-step">

<a id="report"></a>

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

:::caution[Labels not confirmed in step 2]
The report definition screens are not in Workday's public documentation; the field names here describe the result, not the console labels.
:::

</li>

<li class="idp-step">

<a id="web-service"></a>

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

</li>

<li class="idp-step">

<a id="url"></a>

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

:::caution[Labels not confirmed in step 4]
The way to open the web service URLs of a report is not confirmed by a public Workday page.
:::

</li>

<li class="idp-step">

<a id="credentials"></a>

### 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`](/errors/directory_source_credentials_invalid/), [`directory_source_unavailable`](/errors/directory_source_unavailable/)

</li>

<li class="idp-step">

<a id="preview"></a>

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

</li>

<li class="idp-step">

<a id="who"></a>

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

</li>

</ol>

## Sources

- [Concept: Reports-as-a-Service (RaaS) (Workday)](https://developer.workday.com/documentation/hto1529968349582), read on 2026-10-30
