Workday
  • 06 Feb 2025
  • 2 Minutes to read
  • Dark
    Light

Workday

  • Dark
    Light

Article summary

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

  1. Admin access to Workday to create an integration system user, register an API client and add permissions

  2. Admin access to DataBee console to add new feed

Configuration Overview

  1. Workday

    1. Create an Integration System User (ISU) in Workday

    2. Register an API Client for Integrations associated with the ISU in Workday to get the Client ID, Client Secret and Refresh Tokens

    3. Create a Security Group, assign permissions and add ISU as member

  2. DataBee: Create a new Workday feed and add API tokens

Parameter Mapping

Workday Configuration

Step 1: Create Integration System User

  1. Login to Workday as an admin and search for “Create Integration System User”

A screenshot of a computer  AI-generated content may be incorrect.

  1. In the dialog box, fill in required fields of the form and click OK

A screenshot of a computer  AI-generated content may be incorrect.

Step 2: Registering API Client for Integrations

  1. Search for “Register API Client for Integrations”

  1. In the dialog box, enter the required fields of the form

    1. Name

    2. Non-Expiring Refresh Tokens: SELECT

    3. Disabled: UNSELECT

    4. Scope: Add the following

      1. Implementation

      2. Integration

      3. System

      4. Tenant Non-Configurable

    5. Include Workday Owned Scope: SELECT

A screenshot of a computer  AI-generated content may be incorrect.

Workday API Client ID & Secret

  1. Click OK and save the Client ID and Client Secret

A screenshot of a computer  AI-generated content may be incorrect.

Workday API URLs

  1. Record the datacenter and tenant name

  1. Search for “View API Clients” in Workday

A screenshot of a computer  AI-generated content may be incorrect.

  1. Under the API Clients for Integrations  tab, select the newly registered API client above.

A screenshot of a computer  AI-generated content may be incorrect.

  1. From “Related Actions”, select ‘API Client’ > ‘Manage Refresh Tokens for Integrations’

A screenshot of a computer  AI-generated content may be incorrect.

  1. In the Workday Account field, select the newly created integration user (Task 1) and click OK

A screenshot of a computer  AI-generated content may be incorrect.

Workday Refresh Token For Integrations

  1. Check Generate New Refresh Token and click OK.

A screenshot of a computer  AI-generated content may be incorrect.

  1. Copy and save the generated Refresh Token

  2. At this point, you will have the Refresh Token, Client ID and Client Secret.

Step 3: Editing Security Policy

  1. Search for “Create Security Group”

A screenshot of a chat  AI-generated content may be incorrect.

  1. Fill in the fields:

    1. Type of Tenanted Security Group: Integration System Security Group (Unconstrained)

    2. Name: assign a name

A screenshot of a security group  AI-generated content may be incorrect.

  1. Select the newly created Integration System User (Task 1)

A screenshot of a computer  AI-generated content may be incorrect.

  1. From ‘Related Actions’, select Security Group > Maintain Domain Permissions for Security Group

A screenshot of a computer  AI-generated content may be incorrect.

  1. Add the following Get and View permissions to the group

  1. Activate the Security Policy Changes

A screenshot of a computer  AI-generated content may be incorrect.

DataBee Configuration 

  1. Log into the DataBee console, navigate to the Data>Data source tab and click the Add New Data Source button

A screenshot of a computer  Description automatically generated 

  1. Search for Workday and click it A screenshot of a computer  Description automatically generated 

  2. Click on the API Ingest option for the collection method. 

A screenshot of a computer  Description automatically generated 

  1. Provide contact information for the Workday source, and click Next 

DataBee Feed Configuration

  1. In the configuration dialog, enter the following:

    1. Select the event type and enter the tenant name.

    2. Refresh Token: Paste the Workday Refresh Token

    3. Client Key: Paste Workday Client ID

    4. Client Secret: Paste Workday Client Secret

    5. Token URL: Replace the <tenant> placeholder

    6. API URL: Ensure the datacenter in the API Base URL matches Workday REST endpoint

A screenshot of a computer  AI-generated content may be incorrect.

  1. Click Submit 

  


Was this article helpful?

What's Next
Changing your password will log you out immediately. Use the new password to log back in.
First name must have atleast 2 characters. Numbers and special characters are not allowed.
Last name must have atleast 1 characters. Numbers and special characters are not allowed.
Enter a valid email
Enter a valid password
Your profile has been successfully updated.
ESC

Eddy AI, facilitating knowledge discovery through conversational intelligence