> ## Documentation Index
> Fetch the complete documentation index at: https://docs.truu.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect Workday

> Connect TruU IDV to Workday through a custom report and an integration system user: the report to build, the access to grant, the values to enter, and how to test it.

This page is for the Workday administrator connecting TruU IDV. When you finish, TruU can look up one worker at a time during verification through a report you control.

> [!NOTE]
>
> The Workday connector is in **Preview**: built from Workday's published report web service and tested against it, not yet against a live customer tenant. Run a test lookup before relying on it.

## Before you start

* A Workday administrator who can create an integration system user, a security group, a custom report and an API client.
* Your Workday **services host** and **tenant name**, both shown under **View URLs** in Workday.
* The Workday Employee ID of someone to test with.
* An **Owner** or **Admin** seat in TruU IDV.

## Restricted account

TruU reads only the columns of the report you build, so the report is your control. Add only the columns below, and only the optional ones you use.

**1. Create an integration system user**

Create an integration system user (ISU) for TruU and an integration system security group containing it.

**2. Grant view access to the data in the report**

Give the security group **Get** (view) access to the domains that hold the report's fields: worker name, date of birth, home contact information and employment status. Grant nothing else.

## Build the report

Create an **Advanced** custom report on **Workers for HCM Reporting** named `TruU_IDV_Person`.

* **Prompts:** two optional text prompts, `Employee_ID` and `Work_Email`. TruU sends only the one its lookup uses.
* **Terminated workers:** set `Include_Terminated_Workers` to **Yes** by default, so TruU can tell an inactive worker from one who doesn't exist.
* **Web service:** turn on **Enable as Web Service**, and share the report with the ISU's security group.
* **Columns:** use exactly these column aliases. Use the primary home address and primary personal email and phone, so each column has one value.

| Column alias | Field |
| - | - |
| `Employee_ID` | Employee ID |
| `Work_Email` | Primary work email |
| `Legal_First_Name`, `Legal_Last_Name` | Legal name |
| `Date_of_Birth` | Date of birth |
| `Is_Terminated` | Terminated (true or false) |
| `Personal_Email`, `Personal_Phone` | Primary home email and phone |
| `Home_Address_Line_1`, `Home_City`, `Home_Region`, `Home_Postal_Code`, `Home_Country` | Primary home address |

Add any column you want as a custom attribute in TruU, for example `Cost_Center`. Don't add sensitive columns TruU doesn't use: a test lookup warns you when the report includes them.

## Set it up

**1. Choose how TruU signs in**

**OAuth refresh token** (recommended): register an API client for integrations in Workday and create a refresh token for the ISU. Or use the ISU's **username and password**.

**2. Open Workday in TruU**

Go to **Settings → Directory** and, under **HR system**, choose **Workday**.

**3. Enter the details**

Enter the **Services host**, **Tenant name**, **Report owner** (the user who owns the report) and **Report name** (`TruU_IDV_Person` unless you named it differently), then the credentials for the sign-in method you chose.

**4. Test and connect**

Enter a **Workday Employee ID** to test with and choose **Test and connect**.

**5. Review finding people and attributes**

By default TruU matches the directory's **Employee Id** to the Workday Employee ID. Workday lists custom attributes from the report's columns after a test lookup. Choose **Save changes**. See [Finding people](https://docs.truu.ai/idv/connect/hr/overview.md#finding-people).

## Test it

Choose **Test lookup** on the Workday page. TruU runs the report for one worker and shows which columns came back as **Present** or **Missing**, and lists any other columns as attributes you can add.

## How it works

* **One call per lookup.** TruU runs your report with one prompt and reads the single row it returns.
* **Sign-in.** With OAuth, TruU exchanges the refresh token for a short-lived access token and caches it. Credentials are stored in a managed secrets service.
* **Report owner.** The report's URL includes its owner. If a tenant refresh changes the owner, update **Report owner** in TruU.

> [!WARNING]
>
> If Workday can't answer, or you disconnect it, checks that read Workday are skipped and verification continues. See [When HR is unavailable](https://docs.truu.ai/idv/connect/hr/overview.md#when-hr-is-unavailable).

## Troubleshooting

| Symptom | Cause | Fix |
| - | - | - |
| **The report failed** | A prompt or column alias doesn't match, or the report isn't enabled as a web service | Check the prompt names and aliases against the table above |
| **Workday rejected the sign-in** | The refresh token was revoked or the password changed | Create a new token and use **Rotate credentials** |
| Terminated workers show **No match** | `Include_Terminated_Workers` isn't **Yes** | Change the report default |
| A column is **Missing** for everyone | The security group can't see that field | Grant **Get** on the domain that holds it |

## Related

* [Connect your HR system](https://docs.truu.ai/idv/connect/hr/overview.md)
* [Proofing](https://docs.truu.ai/idv/factors/proofing/overview.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.