Connect

Use this guide to configure a custom Workday RaaS report that exposes employee data in JSON format for Zluri to ingest.

Prerequisites

Report Writer permissions in Workday
Ability to create and share a web-enabled custom report
Access to create an Integration System User and security groups
Employee data field list shared by Zluri
Admin access to Zluri

Step 1: Create a Custom Report in Workday

1. Log in to Workday with Report Writer permissions.

2. In the search bar, enter: Create Custom Report.

3. Fill the following:

Name: Zluri_RaaS_Report
Report Type: Advanced
Data Source: All Active Employees or equivalent
Enable: ✅ Enable as Web Service

4. Click OK to continue.

Step 2: Add Required Fields

1. Add the fields exactly as defined in the Zluri schema. Refer to the shared spreadsheet for field names, types, and formats. Field names are case-sensitive and must match exactly.

2. Ensure the following:

Use the Zluri field mappings column for exact names (e.g., reportingManagerEmail, isActive, createdAt)
Apply correct data types:
- string, email, array, enum, or date format: yyyy/mm/dd
For isActive, supported enum values include:
TRUE, true, True, FALSE, false, False

3. Click OK and Save the report after mapping all required fields.

Here's the complete list of fields to include:

Workday Field Examples	Zluri Field Mapping	Type	Notes
Work Email	email	email
Personal Email	personalEmail	email
Name	name	string
Username	username	string
First Name	firstName	string
Last Name	lastName	string
Reporting Manager Email	reportingManagerEmail	email
Is Active / Status	isActive	enum	Supported: TRUE, true, True, FALSE, etc.
Department	department	string
Job Title	jobTitle	string
Created At	createdAt	date format: yyyy/mm/dd
Cost Center	costcenter	string
Cost Center Code	costCenterCode	string
Business Unit	businessUnit	string
Location	location	string
Date of Joining	date_of_joining	date format: yyyy/mm/dd
Date of Termination	date_of_termination	date format: yyyy/mm/dd
Employee Type	employeeType	string
Alternate Emails	alternateEmails	array
Unique ID	uniqueId	string
Modified At	modifiedAt	date format: yyyy/mm/dd
Profile Picture	profilePicture	string
Role Name	role	array
License Name	licenseName	array
Last Login / Sign-in Timestamp	lastLogin	date format: yyyy/mm/dd

Step 3: Enable RaaS Access

1. Open the saved report.

2. Go to Actions → Web Services → View URLs

3. Copy the JSON format RaaS URL, for example:

https://{tenant}.workday.com/ccx/service/customreport2/{tenant}/[Public_Report_Path]/Employee_RaaS_Report?format=json

Step 4: Configure API Access

1. Create an Integration System User (ISU)

Go to: Create Integration System User
Username: Zluri_api_employee_data
Set a strong password

2. Create and assign a Security Group

Go to: Create Security Group → Integration System Security Group (Unconstrained)
Add the ISU to this group

3. Assign permissions via Domain Security Policies

Grant access to:

Custom Reports
Worker Data
Job Information
Contact and Personal Information

Step 5: Connect in Zluri

In Zluri, open the Workday – RaaS integration and click Connect Integration.

Enter the following:

Field	Value
API URL	`https://{tenant}.workday.com/.../Employee_RaaS_Report?format=json`
Username	`Zluri_api_employee_data`
Password	`[Secure password created in Step 4]`

Note

Ensure the RaaS report URL is accessible via HTTPS
Share only the JSON version of the URL
All fields used in the report must match the schema exactly
Use secure credentials and limit access via security policies

Updated 3 days ago