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 namedTruU_IDV_Person.
- Prompts: two optional text prompts,
Employee_IDandWork_Email. TruU sends only the one its lookup uses. - Terminated workers: set
Include_Terminated_Workersto 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.
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.
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.

