> ## Documentation Index
> Fetch the complete documentation index at: https://wavecnct.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# UKG

> Create and remove Wave Connect users automatically from your UKG Pro employees

> [!NOTE]
>
> Available on the **Enterprise** plan. This is an organization-level integration, connected by the organization **Owner**. HR integrations are enabled on request: contact Wave Connect to turn it on for your organization.

The UKG integration creates a Wave Connect user for every active employee in UKG Pro and keeps them up to date. When employees join, change roles, or leave, Wave Connect reflects it automatically, so your admins never add or remove accounts by hand. The connection is made to UKG Pro, the UKG human capital management suite.

## How to connect

**1. Ask Wave Connect to enable HR integrations**

Go to **Integrations → UKG**. Until HR integrations are enabled for your organization, the button reads **Contact Us**. Click it to send the request to Wave Connect support.

**2. Install the app**

Once enabled, click **Install App**. Leave **Automatically import new users from UKG** on to keep the directory in sync, then click **Continue**.

**3. Sign in to UKG Pro**

A secure Merge Link window opens. Sign in with your UKG Pro credentials and authorize read access to your employees.

**4. Wait for the first import**

Wave Connect imports all active employees right after connecting. Each one becomes a Wave Connect user in your organization.

> [!NOTE]
>
> This integration can add seats automatically as new employees are imported, which can lead to additional charges.

## What gets synced

| UKG Pro field | Wave Connect user field |
| - | - |
| First name, last name | Name |
| Work email | Email (used to sign in) and work email |
| Personal email | Personal email |
| Mobile phone | Mobile phone (only when the number is valid) |
| Job title (current employment) | Job title |
| Work location city | City |
| Profile photo | Profile photo |
| UKG employee ID | Stored on the user to match future updates |

**Sync direction**: UKG Pro → Wave Connect (inbound only)

**When**: A full import when you connect, then employee added, changed, and removed events as UKG Pro reports them through Merge.

## Features

* **Automatic onboarding**: new employees get a Wave Connect account with their name, title, photo, and contact details already filled in.
* **Automatic offboarding**: when an employee is removed in UKG Pro, or their termination date passes, their Wave Connect user is deleted. This frees their card and removes their profile and contacts.
* **Duplicate-safe matching**: employees are matched to existing Wave Connect users by their UKG employee ID first, then by work email, so people who already had an account are updated rather than duplicated.

## Limitations & requirements

* Only employees with a first name, last name, and work email in UKG Pro are imported. Anyone missing one of these fields is skipped.
* Employees whose termination date has already passed are not imported.
* Work phone numbers are not imported.
* Imported users are created with the **User** role. Assign teams and admin roles in Wave Connect.
* This is an organization-level integration. Individual team members do not connect separately.
* The connection is made to UKG Pro. Other UKG products are not supported.

## Disconnecting

Go to **Integrations → Installed Integrations**, open **UKG**, and click **Disconnect**. This stops syncing, removes the connection in Merge, and deletes the integration. Existing Wave Connect users are not deleted.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.