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

# Connecting Workday HRIS with Oloid Cloud Platform

> This document explains how to integrate Workday HRIS with the Oloid Cloud Platform, with Workday serving as the system of record for employee and...

This document explains how to integrate **Workday HRIS** with the **Oloid Cloud Platform**, with Workday serving as the system of record for employee and organizational data. The integration supports key workforce use cases, including:

* **Workday Time Clock Enablement** – Ensures accurate employee, position, schedule, and employment status data for compliant and reliable time punches.
* **Automated Employee Onboarding & Offboarding** – Provisions and de-provisions users automatically in downstream systems such as **Brivo**, **Microsoft Entra ID**, **ProWatch**, and other connected platforms.

By enabling **real-time or near real-time data synchronization**, the Workday–Oloid integration delivers the following operational and security benefits:

* **Reduced Human Errors** – Eliminates manual data entry and minimizes data inconsistencies.
* **Faster Onboarding** – Enables employees to receive system and facility access as soon as they are onboarded in Workday.
* **Secure Offboarding** – Ensures timely removal of access when an employee leaves the organization.
* **Data Consistency Across Systems** – Maintains a single, accurate source of truth across all integrated platforms.
* **Operational Efficiency** – Reduces administrative overhead and manual coordination efforts.
* **Improved Compliance & Audit Readiness** – Helps meet internal policies and regulatory requirements through accurate and timely data updates.

Now, let's walk through the steps to generate credentials in Workday for user provisioning in Oloid Cloud Platform:

💡 To follow the below steps you require administrative access on your organization's Workday account.

## Step 1: Create an Integration System User

1. In Workday, use the search bar to navigate to the **Create Integration System User** task, and click on the option presented. (see screenshot 'Step 1.1' below)
2. Createanew **Username** (in this example we'll use 'workday\_user\_provisioning'and **Password**. Ensure you have a copy of this information as you will need it later.
3. Ensure the following fields are set as stated below:
   1. 'Require new password at Next Sign in' is **unchecked**
   2. 'Session Timeout Minutes' is set to '**0**'.
   3. 'Do Not Allow UI Sessions' is **checked**
4. Click **OK** to create the integration system user.

👉 Make a note of your Username and Password as it will be needed for the integration request.

*Step 1.1*

![Connecting Workday HRIS with Oloid... - screenshot 1](https://mintcdn.com/oloid-999c42b2/WXHXDJmtltQfhUml/images/intercom/12688798/image-3a121c07.png?fit=max\&auto=format\&n=WXHXDJmtltQfhUml\&q=85\&s=c171fa77a030ddfa93510e99e0a424e9)

*Step 1.2-1.4*

![Connecting Workday HRIS with Oloid... - screenshot 2](https://mintcdn.com/oloid-999c42b2/WXHXDJmtltQfhUml/images/intercom/12688798/image-adaeced3.png?fit=max\&auto=format\&n=WXHXDJmtltQfhUml\&q=85\&s=81d21dbe16c82b775dbb6b145529b9d1)

## Step 2: Create an Integration Security Group

1. Use the search bar to navigate to the **Create Security Group** task.
2. For the **Type of Tenanted Security Group** drop down select **Integration System Security Group (Unconstrained)**
3. **Create a name** for this security group, for example, `'xyz demo_user_provisioning'`
   👉 Make a note of this as you will need it in the next step and click OK.
4. In the **Integration System User** field **select the name** you created in step 1 ('workday\_user\_provisioning')
5. Click **OK**
6. Click **Done**

*Step 2.2 - 2.3*

![Connecting Workday HRIS with Oloid... - screenshot 3](https://mintcdn.com/oloid-999c42b2/WXHXDJmtltQfhUml/images/intercom/12688798/image-7536b276.png?fit=max\&auto=format\&n=WXHXDJmtltQfhUml\&q=85\&s=6d896415ce4d40e0ebff977d2dcfc904)

*Step 2.4 - 2.5*

![Connecting Workday HRIS with Oloid... - screenshot 4](https://mintcdn.com/oloid-999c42b2/WXHXDJmtltQfhUml/images/intercom/12688798/image-f1ae1244.png?fit=max\&auto=format\&n=WXHXDJmtltQfhUml\&q=85\&s=39e65cd66e6b45981b21de63b55998b0)

## **Step 3:** Setup Integration System Users for Inbound and Outbound and Integration User Group(s) for Securable items in Workday

1. Add the domains that you want to sync with OLOID to the security group. All domains are listed in a Configurable Security Matrix. You need to add all domains directly –
   1. Search for **Maintain Permission for Security Group** and select it.
      Make sure to add following Domain Security Policies.

**For Integration**

**Operation**

**Domain Security Policy**

**Functional Areas**

Get Only

Integration Event

Integration

Get Only

Integration Process

Integration

Get Only

Integration Debug

Integration

Get Only

Integration Build

Integration

**For Worker Data**

**Operation**

**Domain Security Policy**

**Functional Areas**

Get Only

Worker Data: All Positions

Staffing

Get Only

Worker Data: Organization Information

Staffing

Get Only

Worker Data: Workers

Staffing

Get Only

Worker Data: Current Staffing Information

Staffing

Get Only

Person Data: Name

Contact Information

Get Only

Worker Data: Public Worker Reports

Staffing

Get Only

Person Data: Work Contact Information

Contact Information

View Only

Worker Data: Current Staffing Information

Staffing

View Only

Worker Data: Historical Staffing Information

Staffing

**For Time Punch**

**Operation**

**Domain Security Policy**

**Functional Areas**

View and Modify

Set Up: Time Tracking

Time Tracking
Time Tracking Hub

Get and Put

Time Tracking: Edit Time Clock Event Date and Time

Time Tracking

View and Modify

Process: Time Clock Event Processing

Time Tracking

View and Modify

Process: Time Clock Event REST API's

Time Tracking

Get and Put

Process: Time Clock Event REST API's

Time Tracking

b. Search for correct Source Security Group.

c. Edit View/Modify access wherever applicable.

![Connecting Workday HRIS with Oloid... - screenshot 5](https://mintcdn.com/oloid-999c42b2/WXHXDJmtltQfhUml/images/intercom/12688798/image-25554f80.png?fit=max\&auto=format\&n=WXHXDJmtltQfhUml\&q=85\&s=a94c715df3564e5d20256b2d9d979176)

## Step 4: Activate the Security Policies

1. Use the search bar to navigate to the **Activate Pending Security Policy Changes** task.
2. Enter a comment, for example, 'activated demo\_course'.
3. Click **OK**, then review the permissions.
4. Check the **Confirm** check box and click **OK.**
5. The next page will confirm activation.

*Step 4.2*

![Connecting Workday HRIS with Oloid... - screenshot 6](https://mintcdn.com/oloid-999c42b2/WXHXDJmtltQfhUml/images/intercom/12688798/image-f9b95d58.png?fit=max\&auto=format\&n=WXHXDJmtltQfhUml\&q=85\&s=488a8406503374469bfd5792f2a5631c)

## Step 5: Register the API Client for Integrations

1. Use the search bar to navigate to the **Register API Client for Integrations** task.
2. In the form that appears, fill in:
   * Client Name: e.g., `ACI_Oloid_HCM`
   * Non-Expiring Refresh Tokens: Checked
   * Disabled: Unchecked
   * Scope (Functional Areas): Add at least Worker Profile and Skills, Staffing, System
     * Make sure to add following **Scope (functional Areas)**
       **For Worker Data**
       1. Staffing
       2. Contact Information
       3. Adaptive Planning for Financial Plans (For WQL export)
       4. Adaptive Planning for the Workforce (For WQL export)
       5. System (For WQL export)

**For Time Punch**

1. Time Tracking

* Include Workday Owned Scope: Unchecked
* Restricted to IP Ranges: None
  (see screenshot 'Step 5.2' below)

3. Click OK.
4. On the next page, you'll be able to see your **Client ID** and **Client Secret**.

👉 Make note of the **Client ID** and **Client Secret** as you will need to share these with your Oloid Cloud Platform Integrations specialist.

*Step 5.2*

![Connecting Workday HRIS with Oloid... - screenshot 7](https://mintcdn.com/oloid-999c42b2/WXHXDJmtltQfhUml/images/intercom/12688798/image-29ab798a.png?fit=max\&auto=format\&n=WXHXDJmtltQfhUml\&q=85\&s=67e43e9cc125c1951a5e66097c9777f4)

*Step 5.4*

![Connecting Workday HRIS with Oloid... - screenshot 8](https://mintcdn.com/oloid-999c42b2/WXHXDJmtltQfhUml/images/intercom/12688798/image-ae50656d.png?fit=max\&auto=format\&n=WXHXDJmtltQfhUml\&q=85\&s=0527cdee0f5acf825766f3b3564f9e0e)

## Step 6: Generate a Refresh Token

1. Use the search bar to navigate to the **View API Clients** report.
2. Take note of the **Workday REST API Endpoint**, **Token Endpoint**, and **Authorization Endpoint** as you will need to share these with your Oloid Cloud Platform Integrations consultant. (see screenshot 'Step 6.2' below)
3. Select the **API Clients for Integrations** tab and locate the API Client created in the previous step. Press the 3 dots and select **API Client > Manage refresh tokens for Integrations**.
4. In the pop-up that appears, select the ISU created in an earlier step.
5. Tick **Generate New API Token** and press OK. A new refresh token will appear in the list.

👉 Make note of this as you will need to share it with your Oloid Cloud Platform Integrations consultant.

*Step 6.2*

![Connecting Workday HRIS with Oloid... - screenshot 9](https://mintcdn.com/oloid-999c42b2/WXHXDJmtltQfhUml/images/intercom/12688798/image-b0aa7e04.png?fit=max\&auto=format\&n=WXHXDJmtltQfhUml\&q=85\&s=adad5c3af6f5b3a8c75ff279825f34ef)

*Step 6.3*

![Connecting Workday HRIS with Oloid... - screenshot 10](https://mintcdn.com/oloid-999c42b2/WXHXDJmtltQfhUml/images/intercom/12688798/image-f645a148.png?fit=max\&auto=format\&n=WXHXDJmtltQfhUml\&q=85\&s=3545a18d4d65966ddc39a3403f08a53a)

*Step 6.5*

![Connecting Workday HRIS with Oloid... - screenshot 11](https://mintcdn.com/oloid-999c42b2/WXHXDJmtltQfhUml/images/intercom/12688798/image-8a08686b.png?fit=max\&auto=format\&n=WXHXDJmtltQfhUml\&q=85\&s=c2dd7fda83de8db8927c783ae6945c89)

## Step 7: Create a Custom Report and Obtain the WQL Query

1. Use the search bar to navigate to the **Create Custom Report** tab. In the dialog, name the report, select **Report Type: Advanced**, and **Data Source: Workers for HCM Reporting**. (see screenshot 'Step 7.1' below)
2. Create a report that comprises all the data that you would like to use in Oloid Cloud Platform. At a minimum, add Workday ID, First Name, Last Name, and Email Address. You may also add other metadata like title, department, location, etc.
3. Save the report.

Use the search bar to navigate to the **Convert report to WQL report**. In the dialog, select the custom report you just created. A new screen will appear. Take note of the query under the heading “Converted WQL Query String”. It should look something like:

```
SELECT workdayID, firstName, lastName, email_PrimaryWork FROM workersForHCMReporting
```

*Step 7.1*

![Connecting Workday HRIS with Oloid... - screenshot 12](https://mintcdn.com/oloid-999c42b2/WXHXDJmtltQfhUml/images/intercom/12688798/image-e2aeec67.png?fit=max\&auto=format\&n=WXHXDJmtltQfhUml\&q=85\&s=48b919ae15374f4236d2ceb7be2a4dd0)

*Step 7.2*

![Connecting Workday HRIS with Oloid... - screenshot 13](https://mintcdn.com/oloid-999c42b2/WXHXDJmtltQfhUml/images/intercom/12688798/image-8df4f960.png?fit=max\&auto=format\&n=WXHXDJmtltQfhUml\&q=85\&s=7a88bab29d4d6c82f3fc7c265dec6982)

![Connecting Workday HRIS with Oloid... - screenshot 14](https://mintcdn.com/oloid-999c42b2/WXHXDJmtltQfhUml/images/intercom/12688798/image-985dcd3d.png?fit=max\&auto=format\&n=WXHXDJmtltQfhUml\&q=85\&s=a000e9ab48f2a95daebea1eb2f33a056)

## **Step 8: Share with** Oloid Cloud Platform

After completing the above steps, you should have the following information:

* **Client ID** and **Client Secret** (from Step 5)
* **Refresh Token** (from Step 6)
* **Workday REST API Endpoint, Token Endpoint, Authorization Endpoint** (from Step 6)
* **WQL Query String** (from Step 7)

Please provide this information to your Oloid Cloud Platform CSM or Integrations consultant to complete the integration process.

💡 Remember, the steps above are for a demo scenario. The names and settings you use may vary based on your organization's specific needs and policies. Always ensure you're following your organization's security guidelines when creating and managing users and permissions.
