Overview
This guide will walk you through connecting your UKG Pro Workforce Management (formerly UKG Dimensions) account to Doozy to sync employee data.Prerequisites
Before you begin, ensure you have:- Administrator access to your companyโs UKG Pro WFM instance
Credentials Required
- Client ID - Provided when your tenant was provisioned
- Client Secret - Provided when your tenant was provisioned
- Username - API user credentials
- Password - API user credentials
- Subdomain - Your UKG Pro WFM subdomain
If you donโt have access to your Client ID or Client Secret, contact UKG Global Support for assistance.
Steps
Step 1: Create an API User
- Identify an existing admin user who has access to all employees and locations
- Go to Menu โ Maintenance โ People Information
- Duplicate the user account by selecting the person and going to Person โ Duplicate
- In the new profile:
- Select Edit Licenses and confirm at least a Manager license is selected
- Under the Information section:
- Set the Last Name to
APIUser - Set the ID to
APIUser(or another unused user ID) - Assign a new Username (e.g.,
APIUser) - Set the Authentication Type to Basic
- Assign and confirm a password
- Check API Only User (this ensures the password does not expire)
- Set the Last Name to
- Under the Access Profiles section:
- Set Function Access Profile and Display Profile to Super Access (or configure more restrictive access if needed)
Step 2: Create a Function Access Profile (if needed)
If you didnโt copy the function access profile from an existing user:- Log into WFM with an administrative account
- Navigate to Administration โ Application Setup
- Expand Access Profiles and click Function Access Profiles
- Click New
- Configure the profile:
- Enter a Name (e.g., the name of the application youโre connecting)
- Set the function access profile to Super Admin access
- Click Save & Return
- Assign this function access profile to your API user
Step 3: Identify Your Subdomain
Your subdomain is part of your UKG Pro WFM URL. For example, if your URL ismerge.prd.mykronos.com, your subdomain is merge.prd.
Enter Credentials into Doozy
You must be a workspace admin to connect an HRIS integration.
- Navigate to Workspace Settings
- Click Integrations in the sidebar
- Select HRIS
- Choose UKG Pro Workforce Management from the list of providers
- Enter your Username and Password
- Enter your Client ID and Client Secret
- Enter your Subdomain
- Click Connect to complete the integration