- 06 Feb 2025
- 2 Minutes to read
- Print
- DarkLight
Workday
- Updated on 06 Feb 2025
- 2 Minutes to read
- Print
- DarkLight
Workday is a provider of cloud-based software that specializes in applications for enterprise resource planning (ERP) and human capital management (HCM). DataBee integrates with Workday for the purpose of building the organization hierarchy, which is used in other views.
Integration Method: API
Tables: User Inventory, Authentication, Web Resource Activity
Data Pulled | |
Workers | Get worker name, id and organization |
SupervisoryOrganizations | Get organization and manager details |
This integration has been tested against the Workday staffing API version v6 and common API version v1.
Prerequisites
Admin access to Workday to create an integration system user, register an API client and add permissions
Admin access to DataBee console to add new feed
Configuration Overview
Workday
Create an Integration System User (ISU) in Workday
Register an API Client for Integrations associated with the ISU in Workday to get the Client ID, Client Secret and Refresh Tokens
Create a Security Group, assign permissions and add ISU as member
DataBee: Create a new Workday feed and add API tokens
Parameter Mapping
DataBee Parameter | Workday Parameter |
Workday Configuration
Step 1: Create Integration System User
Login to Workday as an admin and search for “Create Integration System User”
In the dialog box, fill in required fields of the form and click OK
Step 2: Registering API Client for Integrations
Search for “Register API Client for Integrations”
In the dialog box, enter the required fields of the form
Name
Non-Expiring Refresh Tokens: SELECT
Disabled: UNSELECT
Scope: Add the following
Implementation
Integration
System
Tenant Non-Configurable
Include Workday Owned Scope: SELECT
Workday API Client ID & Secret
Click OK and save the Client ID and Client Secret
Workday API URLs
Record the datacenter and tenant name
Search for “View API Clients” in Workday
Under the API Clients for Integrations tab, select the newly registered API client above.
From “Related Actions”, select ‘API Client’ > ‘Manage Refresh Tokens for Integrations’
In the Workday Account field, select the newly created integration user (Task 1) and click OK
Workday Refresh Token For Integrations
Check Generate New Refresh Token and click OK.
Copy and save the generated Refresh Token
At this point, you will have the Refresh Token, Client ID and Client Secret.
Step 3: Editing Security Policy
Search for “Create Security Group”
Fill in the fields:
Type of Tenanted Security Group: Integration System Security Group (Unconstrained)
Name: assign a name
Select the newly created Integration System User (Task 1)
From ‘Related Actions’, select Security Group > Maintain Domain Permissions for Security Group
Add the following Get and View permissions to the group
Activate the Security Policy Changes
DataBee Configuration
Log into the DataBee console, navigate to the Data>Data source tab and click the Add New Data Source button
Search for Workday and click it
Click on the API Ingest option for the collection method.
Provide contact information for the Workday source, and click Next
DataBee Feed Configuration
In the configuration dialog, enter the following:
Select the event type and enter the tenant name.
Refresh Token: Paste the Workday Refresh Token
Client Key: Paste Workday Client ID
Client Secret: Paste Workday Client Secret
Token URL: Replace the <tenant> placeholder
API URL: Ensure the datacenter in the API Base URL matches Workday REST endpoint
Click Submit