Integrating with Workday® HCM

With the Kudos® platform Workday® integration, employees can be imported from Workday® HCM, and their HR information will be synced into the Kudos®. This eliminates the need to perform manual, duplicate entry of employee information in both systems.

Requirements:

• API Access to the Workday Human Resources Webservice: please contact your Workday administrator to create a system integration user that is capable of reading from the Get_Workers API endpoint under the Human Resources Webservice.
• The Integration is developed and tested against Workday Web Services (WWS) version 31.
• Administrator privileges in the Kudos® platform.

Setup:

After acquiring the Workday integration user credentials which include a username, password, and API URL, access your Kudos® account and navigate to Admin ⚙️ > Account Settings > Integrations > Workday > Connect.

Next, enter the API URL, where tenant_id is specific to your organization. Enter the Workday integration user credentials and select the Kudos® Administrator user that will receive the sync reports.

Click Connect to Workday to activate the integration and validate the credentials to ensure future sync processes are successful.

After activating the integration, you will have the option to enable daily automatic sync or pull users manually:

Once the sync has started, the process may take a while depending on the number of users being synced. At the end of the process, the selected Administrator user will receive an email from Kudos® with the following information once your sync is complete:

• New UsersAdded
• Supervisors Created
• Users Updated
• Users Archived 
• Users Re-Activated

New users will still need to be invited to join your Kudos® system unless you have automatic invitations turned on in your Kudos® settings. More information on inviting users can be found here: Inviting Users to the Kudos® platform.

On the first user import, the integration will match on email; after that, users will be assigned their own unique ID (ie: workday_435) that is managed to connect users. 

If the Workday integration user credentials change at any point after setting up the integration, please be sure to update them in Kudos® to ensure your Workday integration continues to sync. 

Attribute Mappings

The following fields / Attributes are synced one-way from Workday to Kudos®. Values in Workday will always override what has been set in Kudos®: