> ## Documentation Index
> Fetch the complete documentation index at: https://nango-marcin-get-deployments-docs.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# UKG Pro - How do I link my account?

# Overview

To authenticate with UKG Pro, you need:

1. **Service Account Username** - The username for your UKG Pro service account
2. **Service Account Password** - The password generated for your UKG Pro service account
3. **Customer API Key** - Your UKG Pro Customer API Key found in Service Account Administration
4. **Hostname** - The tenant URL of your UKG Pro instance (e.g. servicet.ultipro.com)

This guide will walk you through finding your Customer API Key, setting up a service account, and locating your hostname.

### Prerequisites:

* You must have UKG Pro system administrator rights to create service accounts

### Instructions:

#### Step 1: Finding Your Customer API Key

To find your Customer API Key in UKG Pro:

1. Open the Service Account Administration page
   * Click "Settings" from the side menu
   * Go to the "Security" tab
   * Select "Service Account Administration"
   <img src="https://mintcdn.com/nango-marcin-get-deployments-docs/QJDtJlbbTcxkOCz3/integrations/all/ukg-pro/service-account-tab.png?fit=max&auto=format&n=QJDtJlbbTcxkOCz3&q=85&s=03740f0f713c1fe196c92318dd7abda3" width="388" height="936" data-path="integrations/all/ukg-pro/service-account-tab.png" />
2. Locate your Customer API Key
   * The Customer API Key will be displayed at the top of the page

<img src="https://mintcdn.com/nango-marcin-get-deployments-docs/QJDtJlbbTcxkOCz3/integrations/all/ukg-pro/service-account.png?fit=max&auto=format&n=QJDtJlbbTcxkOCz3&q=85&s=37bbd2b66615b6b3528a6cffffdf4788" width="1086" height="659" data-path="integrations/all/ukg-pro/service-account.png" />

#### Step 2: Creating a Web Service Account

To create a service account:

1. On the Service Account Administration page, click the Add (+) button located at the top right of the page
   <img src="https://mintcdn.com/nango-marcin-get-deployments-docs/SA2Km1Mnz5zcbziZ/integrations/all/ukg-pro/add-service-account.png?fit=max&auto=format&n=SA2Km1Mnz5zcbziZ&q=85&s=2451f92797b235c4ba8e7c27328b9f9c" width="901" height="124" data-path="integrations/all/ukg-pro/add-service-account.png" />
2. Enter Service Account Details
   * Enter a username for the account
   * Provide an email address
   <img src="https://mintcdn.com/nango-marcin-get-deployments-docs/QJDtJlbbTcxkOCz3/integrations/all/ukg-pro/service-account-details.png?fit=max&auto=format&n=QJDtJlbbTcxkOCz3&q=85&s=d18e31358a7d5a9fe116929f8ab6367f" width="670" height="319" data-path="integrations/all/ukg-pro/service-account-details.png" />
3. Assign Permissions
   * In the Web Services table, assign the appropriate permissions for the API resources you need to access
   <img src="https://mintcdn.com/nango-marcin-get-deployments-docs/QJDtJlbbTcxkOCz3/integrations/all/ukg-pro/service-account-permissions.png?fit=max&auto=format&n=QJDtJlbbTcxkOCz3&q=85&s=49b6a3389e9205e20f6ef9dd3970bf9f" width="894" height="339" data-path="integrations/all/ukg-pro/service-account-permissions.png" />
4. Save and Generate Password
   * Click the Save button at the top of the page
   * A new password will be generated for the account
   <img src="https://mintcdn.com/nango-marcin-get-deployments-docs/SA2Km1Mnz5zcbziZ/integrations/all/ukg-pro/generate-password.png?fit=max&auto=format&n=SA2Km1Mnz5zcbziZ&q=85&s=22034c4be9e04875182a15ad9f2a5329" width="885" height="406" data-path="integrations/all/ukg-pro/generate-password.png" />

#### Step 3: Finding Your Hostname

To locate your hostname:

1. Navigate to **System Configuration > Security > Web Services**
2. Your hostname will be the domain of your service URL (e.g. servicet.ultipro.com)
   * The full service URL might look like "[https://servicet.ultipro.com/services/](https://servicet.ultipro.com/services/)"
   * You only need the hostname portion (servicet.ultipro.com)

<img src="https://mintcdn.com/nango-marcin-get-deployments-docs/QJDtJlbbTcxkOCz3/integrations/all/ukg-pro/web-services.png?fit=max&auto=format&n=QJDtJlbbTcxkOCz3&q=85&s=b0d5c080fdc3af692f919da1d56c3d38" width="1085" height="523" data-path="integrations/all/ukg-pro/web-services.png" />

#### Step 4: Enter credentials in the Connect UI

Once you have gathered all credentials:

1. Open the form where you need to authenticate with UKG Pro
2. Enter your:
   * Service Account Username
   * Service Account Password
   * Customer API Key
   * Hostname (e.g. servicet.ultipro.com)
3. Submit the form, and you should be successfully authenticated

<img src="https://mintcdn.com/nango-marcin-get-deployments-docs/SA2Km1Mnz5zcbziZ/integrations/all/ukg-pro/form.png?fit=max&auto=format&n=SA2Km1Mnz5zcbziZ&q=85&s=90d4a0e86485ea058c30eb96424c8b15" style={{maxWidth: "450px" }} width="761" height="1461" data-path="integrations/all/ukg-pro/form.png" />

You are now connected to UKG Pro.
