UKG + Konnectify
UKG Integration with Konnectify
Connect UKG Pro HCM data to Konnectify to automate HR/HCM workflows—sync employee/person changes, track terminations, and pull payroll/compensation and benefits data using secure credential-based authentication.
Employees People Compensation Payroll Deductions & Benefits Contacts 8 Triggers 23 Actions
What is UKG?
UKG Pro (UKG HCM) is a human capital management platform used to manage employee and person records, employment status changes (including terminations), and HR/payroll-related datasets.
Integrating UKG with Konnectify helps you automatically detect changes in your personnel data and route them into downstream systems (identity, ITSM, payroll reconciliation, finance, and reporting) with reliable polling triggers and data retrieval actions.
New to UKG?
Learn more about UKG Pro HCM and request access to the APIs from your UKG administrator/implementation partner.
Visit UKG →New to Konnectify?
Create a free Konnectify account to build workflows with UKG triggers and actions in minutes.
Sign up for Konnectify →What you can automate
• Detect new hires and new person records
• Detect employee updates (including company-scoped updates)
• Detect terminations and trigger offboarding flows
• Pull employee demographic and employment details
• Sync compensation and pay register data to analytics/finance
• Extract deductions, benefits, and contact information for compliance
API & Authentication
Authentication used by this connector
This UKG connector uses Username + Password (Basic-style credentials) plus a Customer API Key (Konnectify securely stores these connection fields to authenticate API calls).
- Hostname (example: yourcompany.ultipro.com)
- Username
- Password
- Customer API Key
API capabilities covered
- People/Employee profile and person-detail retrieval
- Employment and contract details
- Compensation information (including company/employee filtering)
- Payroll data (pay register, earnings history, deductions history)
- Deductions & benefits datasets (employee/dependent/open enrollment)
- Employee contacts and COBRA details
Important notes (limits & access)
- API access may require UKG enablement and specific tenant permissions.
- Rate limits and payload size limits are enforced by UKG; Konnectify will surface API errors in run logs.
- For high-volume tenants, prefer company filters and incremental triggers to reduce load.
Official documentation: refer to your UKG Pro API documentation and tenant-specific integration guides. If you don’t have an API portal link, ask your UKG representative/administrator for the correct endpoint references for your tenant. You can also start at UKG API documentation.
How to connect
Prerequisites
- Your UKG tenant Hostname (e.g., yourcompany.ultipro.com)
- A UKG API-enabled Username and Password
- Your Customer API Key provided by UKG
- Konnectify access to create/edit workflows
Add UKG to a Workflow
- Open Konnectify and create a new workflow (or open an existing one).
- Click Add step and choose UKG as the app.
Authorize via credentials + API key
- Select Add new connection.
- Enter Hostname, Username, Password, and Customer API Key.
- Save the connection. Konnectify will use these values to authenticate requests to your UKG tenant.
Configure the Trigger or Action
- Choose a trigger (e.g., New Employee) or an action (e.g., Get Employee By ID).
- If you’re using a “Based On Company” trigger, provide the company filter values as prompted.
- Map output fields into the next steps in your workflow.
Warning
UKG tenants often have strict permissioning. If a step fails with authorization or missing-field errors, confirm the user has the required API permissions and that the hostname matches your tenant domain exactly.
Test the Workflow
- Run a test to validate connectivity and field mapping.
- Review the run output and logs, especially for pagination-heavy actions (compensation, deductions, payroll history).
Activate the Workflow
- Turn the workflow on.
- For polling triggers, allow time for the next poll cycle to detect new/updated records.
Triggers 8
UKG triggers use polling to detect new or changed records. Cursor-based polling is enabled to help process changes incrementally.
Employees 6 triggers
New EmployeeFires whenever a newly created employee record is added in the UKG personnel module.
New Employee Based On CompanyFires whenever a newly created employee record is added in the UKG personnel module for a filtered company.
Update EmployeeFires whenever an employee record is updated globally (ignores newly created employees).
Update Employee Based On CompanyFires whenever an employee record is updated for a filtered company (ignores newly created employees).
Terminated EmployeeFires whenever an employee's date of termination is updated in the UKG personnel module.
Terminated Employee Based On CompanyFires whenever an employee's date of termination is updated in the UKG personnel module for a filtered company.
People 2 triggers
New PersonFires whenever a newly created person record is added in the UKG personnel module.
New or Updated PersonFires whenever a person record is added or any of its details are updated in the UKG personnel module.
Actions 23
Use UKG actions to retrieve employee/person datasets for enrichment, sync, audits, and reporting. Many list-style actions support filtering and automatic pagination.
People & Employees 8 actions
Get Employee By IDRetrieves employee demographic details from UKG Pro for a specific employee ID.
Get International Employee By Employee IDRetrieves international employee details from UKG Pro for a specific employee ID.
Get All Person DetailsRetrieves employee person details from UKG Pro, with support for filtering and automatic pagination.
Get Person Details By CompanyRetrieves employee person details from UKG Pro for a single company, with support for filtering and automatic pagination.
Get Person Details By Company EmployeeRetrieves a single employee person detail record from UKG Pro for a specific company and employee.
Get Person Details By EmployeeRetrieves a single employee person detail record from UKG Pro by employee ID.
Get Employee Changes By Employee IDRetrieves employee changes since the last API call for a specific employee ID.
Get Business Structure StatusRetrieves a list of Employees for which there is a change in business structure via the Kronos integration endpoint.
Compensation 3 actions
Get Compensation DetailsRetrieves employee compensation details from UKG Pro, with support for filtering and automatic pagination.
Get Compensation Details By CompanyRetrieves employee compensation details from UKG Pro for a specific company, with support for filtering and automatic pagination.
Get Compensation Details By EmployeeRetrieves compensation details from UKG Pro for a specific employee.
Payroll 3 actions
Get Pay RegisterRetrieves pay register details from UKG Pro, with support for filtering by company and employee.
Get Earnings History Base ElementsRetrieves earnings history base elements from UKG Pro, with support for filtering by company and employee.
Get Payroll Deductions HistoryRetrieves payroll deductions history from UKG Pro, with support for filtering by company, employee, check, and employee number.
Deductions & Benefits 5 actions
Get Employee DeductionsRetrieves employee deduction details from UKG Pro, with support for filtering and automatic pagination.
Get Dependent DeductionsRetrieves dependent deduction details from UKG Pro, with support for filtering and automatic pagination.
Get Open Enrollment Employee DeductionsRetrieves open enrollment employee deductions from UKG Pro with pagination.
Get Employee Deduction Benefit Option Change DateRetrieves employee deduction benefit option change date details from UKG Pro, with support for filtering and automatic pagination.
Get Employee Cobra DetailsRetrieves employee COBRA details from UKG Pro, with support for filtering and automatic pagination.
Employment & Contracts 3 actions
Get Employee Employment DetailsRetrieves employee employment details from UKG Pro, with support for filtering and automatic pagination.
Get Employee Contract DetailsRetrieves employee contract details from UKG Pro, with support for filtering and automatic pagination.
Get Employee EducationRetrieves employee education details from UKG Pro, with support for filtering and automatic pagination.
Contacts 2 actions
Get ContactsRetrieves contact details for people assigned to employees as contacts, with support for filtering and automatic pagination.
Get Contact By IDRetrieves a single contact assigned to an employee by contact ID.
Popular automations
New hire enrichment for downstream provisioning
When a new employee is created in UKG, automatically fetch full demographic details to populate identity/IT workflows or HR analytics.
New Employee → Get Employee By ID → Get Person Details By Employee
Termination-driven offboarding data pull
When an employee is terminated, retrieve employment and benefits context for audits, access reviews, and compliance handoffs.
Terminated Employee → Get Employee Employment Details → Get Employee Cobra Details
Compensation monitoring for reporting
On employee updates, pull current compensation details to keep your reporting warehouse or finance models up to date.
Update Employee → Get Compensation Details By Employee
Company-scoped HR sync with payroll verification
For a specific company, detect new employees and retrieve pay register + payroll deductions history for reconciliation workflows.
New Employee Based On Company → Get Pay Register → Get Payroll Deductions History
FAQ
How does authentication work for UKG in Konnectify?
The connector uses a credential-based connection: Hostname, Username, Password, and a Customer API Key. Konnectify stores these securely and uses them to authenticate API calls to your UKG tenant.
Which UKG plans/editions are supported?
Support depends on whether your UKG Pro tenant has the required API endpoints enabled and your user has permission to access them. If an action is not available for your tenant, you’ll typically see authorization/endpoint errors during testing—confirm API enablement with UKG.
Are UKG triggers polling or webhook-based?
All triggers in this connector are polling triggers. Konnectify checks UKG at an interval and uses cursor-based tracking to process new/updated records incrementally.
How do I prevent duplicate records in my downstream systems?
This UKG connector is primarily data-retrieval oriented (no “upsert” action is included here). To avoid duplicates, key your downstream create/update logic on stable identifiers such as Employee ID and/or company + employee composite keys, and add a “lookup-then-create” pattern in the destination app.
How does Konnectify handle UKG rate limits and transient errors?
If UKG returns rate-limit or temporary failures, the workflow run will log the response. For production workloads, use narrower filters (company/employee scoped actions), avoid unnecessarily frequent polling, and consider retry logic/alerting in your workflow design.
Can I connect multiple UKG tenants or multiple UKG users?
Yes. Create multiple Konnectify connections (each with its own hostname/username/password/api key combination), then select the appropriate connection per workflow step.
What’s the difference between “Person” and “Employee” in UKG actions/triggers?
In many UKG configurations, a Person represents an individual’s core identity/profile data, while Employee represents employment-specific records and lifecycle (hire/update/termination). Use person triggers/actions when you need profile-level details, and employee triggers/actions when you need employment status and payroll/benefits context.
Ready to automate your UKG workflows?
Connect UKG to Konnectify to orchestrate HR, payroll, and employee-data automations across your stack.
Get started free →