---
title: How to link your UKG Pro account
description: This guide will walk you through retrieving your Customer API Key and creating a Service User in UKG Pro to complete your linking flow.
---

[Skip to content](https://help.corporategift.com/how-to-link-your-ukg-pro-account#main-content)

English

Show submenu for translations

[Contact us](https://help.corporategift.com/kb-tickets/new?hsLang=en)

Open main navigation

Close main navigation

- English
  
  Show submenu for translations
- [Contact us](https://help.corporategift.com/kb-tickets/new)

 CorporateGift.com Help Center

- There are no suggestions because the search field is empty.

1. [Corporategift.com knowledge base](https://help.corporategift.com/?hsLang=en)
2. [Integrations](https://help.corporategift.com/integrations?hsLang=en)
3. [HRIS](https://help.corporategift.com/integrations?hsLang=en#hris)

# How to link your UKG Pro account

## This guide will walk you through retrieving your Customer API Key and creating a Service User in UKG Pro to complete your linking flow.

 

### Prerequisites

You must be an **Administrator** in your company's UKG Pro instance, or someone has shared their access with you.

### Instructions

#### Step 1: Find your UKG Pro Customer API Key

1. Log in to UKG Pro and search "**Service Account Administration"** on the top right

   [![UKG (1)](https://help.corporategift.com/hs-fs/hubfs/UKG%20(1).png?width=655&height=354&name=UKG%20(1).png)](https://help.corporategift.com/hubfs/UKG%20(1).png?hsLang=en)
2. Copy the Customer API Keyfrom under the header

   [![UKG 2](https://help.corporategift.com/hs-fs/hubfs/UKG%202.png?width=655&height=254&name=UKG%202.png)](https://help.corporategift.com/hubfs/UKG%202.png?hsLang=en)
3. Paste the Customer API Key in the linking flow

   [![Screenshot 2024-10-04 at 16.17.44](https://help.corporategift.com/hs-fs/hubfs/Screenshot%202024-10-04%20at%2016.17.44.png?width=297&height=509&name=Screenshot%202024-10-04%20at%2016.17.44.png)](https://downloads.intercomcdn.com/i/o/1066726733/745d01c637c2d528e950ab34/image.png?expires=1728049500&signature=389882bfb1002f29eb447f42662079221727b3a87b4b6b5612320d6377b403d1&req=dSAhEM58m4ZcWvMW1HO4zR7ljZ2uaCPjopjqcdg5MYhtgbZ%2BL4P9CJ%2FxWrzV%0AzLXn%0A)

#### Step 2: Create your service account

1. On the Service Account Administration Page, click "**+ add"** on the top right

   [![UKG 3](https://help.corporategift.com/hs-fs/hubfs/UKG%203.png?width=655&height=359&name=UKG%203.png)](https://help.corporategift.com/hubfs/UKG%203.png?hsLang=en)
2. Enter in your UKG Pro Admin's account's username and email.
3. You will need the username later

   [![UKG 4](https://help.corporategift.com/hs-fs/hubfs/UKG%204.png?width=655&height=297&name=UKG%204.png)](https://help.corporategift.com/hubfs/UKG%204.png?hsLang=en)
4. On the same page, scroll down under Web Service to enable "View Employee Person Details". This is REQUIRED.

   [![UKG 5](https://help.corporategift.com/hs-fs/hubfs/UKG%205.png?width=655&height=414&name=UKG%205.png)](https://help.corporategift.com/hubfs/UKG%205.png?hsLang=en)
5. Depending on the use case, you may also be required to add some, or all, of these permissions:

     1. Employee Pay Statement
     2. Employee Employment Information
     3. PTO Plan Integration
     4. Company Configuration Integration
     5. Payroll Integration
     6. Personnel Integration
     7. Employee Job History Details
     8. Employee Compensation Details

[![UKG 6](https://help.corporategift.com/hs-fs/hubfs/UKG%206.png?width=688&height=360&name=UKG%206.png)](https://help.corporategift.com/hubfs/UKG%206.png?hsLang=en)

[![UKG 7](https://help.corporategift.com/hs-fs/hubfs/UKG%207.png?width=688&height=375&name=UKG%207.png)](https://help.corporategift.com/hubfs/UKG%207.png?hsLang=en)

1. Click **Save**. Your new password will pop up. Save the password in a secure location
2. [![UKG 8](https://help.corporategift.com/hs-fs/hubfs/UKG%208.png?width=655&height=241&name=UKG%208.png)](https://help.corporategift.com/hubfs/UKG%208.png?hsLang=en)
3. Enter your UKG Pro service account credentials in the linking flow and click Submit  
   This is user name of your admin service user and the password you just generated

   ![Screenshot 2024-10-04 at 16.19.28](https://help.corporategift.com/hs-fs/hubfs/Screenshot%202024-10-04%20at%2016.19.28.png?width=402&height=704&name=Screenshot%202024-10-04%20at%2016.19.28.png)

#### Step 3: Finding your UKG Web Service Domain

1. In your search bar, search for **Web Services**

   [![UKG 9](https://help.corporategift.com/hs-fs/hubfs/UKG%209.png?width=655&height=352&name=UKG%209.png)](https://help.corporategift.com/hubfs/UKG%209.png?hsLang=en)
2. Look at any of the URLs on this page and copy one of them. For example your URL may look something like this: [http://Servicet.ultipro.com/services/BIDataService](http://servicet.ultipro.com/services/BIDataService)

   [![UKG 10](https://help.corporategift.com/hs-fs/hubfs/UKG%2010.png?width=655&height=257&name=UKG%2010.png)](https://help.corporategift.com/hubfs/UKG%2010.png?hsLang=en)
3. Enter the URL into the linking modal.

   [![Screenshot 2024-10-04 at 16.20.45](https://help.corporategift.com/hs-fs/hubfs/Screenshot%202024-10-04%20at%2016.20.45.png?width=347&height=386&name=Screenshot%202024-10-04%20at%2016.20.45.png)](https://downloads.intercomcdn.com/i/o/1088343240/5cac923adaa9ca4f985dd268/CleanShot+2024-06-20+at+15_43_09.png?expires=1728049500&signature=c4c966502f07d5976510da602478ae71e34ad52264c9c07330d480cda81af113&req=dSAvHsp6noNbWfMW1HO4zfZxzxhI0tZxlnpDKQqQD8zwyMRomhDp4dQVsGlN%0Al9s%2F%0A)

- [FAQs](https://help.corporategift.com/faqs?hsLang=en#main-content)

    - [Company Values](https://help.corporategift.com/faqs?hsLang=en#company-values)
- [Getting started](https://help.corporategift.com/getting-started?hsLang=en)
- [General](https://help.corporategift.com/general?hsLang=en#main-content)

    - [FAQ](https://help.corporategift.com/general?hsLang=en#faq)
- [Integrations](https://help.corporategift.com/integrations?hsLang=en#main-content)

    - [SSO](https://help.corporategift.com/integrations?hsLang=en#sso)
    - [CRM](https://help.corporategift.com/integrations?hsLang=en#crm)
    - [Vendors](https://help.corporategift.com/integrations?hsLang=en#vendors)
    - [HRIS](https://help.corporategift.com/integrations?hsLang=en#hris)

[![CorporateGift.com Logo](https://help.corporategift.com/hs-fs/hubfs/Group%20139-2.png?width=200&height=19&name=Group%20139-2.png "CorporateGift.com Logo")](https://corporategift.com)

[CorporateGift.com](http://corporategift.com) Help Center

Copyright © 2026, CorporateGift.com