UKG

Integrate with UKG Pro, Ready, or Dimensions

UKG

Sync employee, payroll, and time data from UKG Pro, UKG Ready, or UKG Dimensions into Audit1.

What syncs: ✅ Employee records ✅ Payroll data ✅ Time & attendance ✅ Job classifications ✅ Work locations ✅ Custom reports


Supported Products

ProductBest ForFormerly
🔵 UKG ProLarge enterprises (1,000+)UltiPro
🟢 UKG ReadyMid-sized (100-1,000)Kronos Workforce Ready
🟡 UKG DimensionsTime & attendance focusedKronos Workforce Dimensions
📘

Setup steps are similar across all products — differences are in where to find credentials.


Prerequisites

  • ✅ Active UKG account (Pro, Ready, or Dimensions)
  • ✅ Administrator access or API permissions
  • ✅ Active Audit1 account

Setup

1️⃣ Start in Your Portal

Go to Settings > Connections > Set Up Connection > Connectors > UKG. Select your product.

2️⃣ Get UKG API Credentials

UKG ProUKG ReadyUKG Dimensions
System Config > Security > Web Services > New Service Account (read-only)Setup > System Config > Integrations & APIs > Generate API KeyAdministration > App Setup > API & Integrations > New Integration
Save: API URL, Username, Password, Customer API KeySave: API Endpoint, API Key, Company Short NameSave: Tenant URL, API Token

3️⃣ Configure Connection

Enter credentials in Audit1 and click Test Connection.

4️⃣ Configure Report Syncing

Create a payroll report in UKG with these fields:

Employee: ID, First Name, Last Name, Status, Hire Date, Termination Date Job: Title, Class Code, Department, Work Location/State Pay: Period Start/End, Gross Pay, Regular Earnings, Overtime, Hours Worked

Enter the Report ID in Audit1's integration settings. Map fields if auto-detection doesn't match.

5️⃣ Set Schedule and Go Live

SettingOptions
⏱️ FrequencyDaily (recommended), weekly, bi-weekly, manual
🔄 Sync typeFull or incremental (changes since last sync)

Run a test sync, verify data, then toggle Auto-Sync ON.


🔧 Troubleshooting

ProblemSolution
❌ Can't connectVerify credentials. Check service account is active. Confirm API access is enabled.
❌ Report not foundVerify report ID. Ensure report has data for date range. Check report permissions.
⚠️ Data mismatchCheck date range and field mappings. Ensure report includes all required fields.
⚠️ Slow syncUse incremental sync. Reduce date range. Run during off-peak hours.

📧

Need help? Email [email protected] with subject "UKG Connector" and your product (Pro/Ready/Dimensions).