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:

Convert the columns in Workday field examples to Zluri field mappings. Zluri requires the report data in JSON with keys exactly named as Zluri Field Mappings.

📘

Zluri Field Mappings values are case sensitive. Additional fields can be added to the report without mappings.

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

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:

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