Skip to main content
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.
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.
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.
If Workday can’t answer, or you disconnect it, checks that read Workday are skipped and verification continues. See When HR is unavailable.

Troubleshooting