Setup the UKG Ready Connection

Connect to AD uses the UKG Ready Saved Reports API to read employee records and determine what data will be transferred to Active Directory.

For a successful setup, you will need to create a UKG Ready Service Account, a Saved Report and a Security Profile specifically designed for Connect to AD, as well as some additional information.

In this five parts guide we will cover:

  1. How to create a UKG Ready Service Account
  2. How to gather the additional information we need for the Connect to AD connection
  3. How to create the Saved Report 
  4. How to configure the Saved Report (as required by Connect to AD)
  5. How to setup the connection to UKG Ready in Connect to AD


Step 1 - Create a Service Account

To create a service account in UKG Ready, navigate to:

  • Settings > Global Setup > Company Setup

nav company setup.png

Then navigate to the Login Config tab and find and select the Service Accounts section.

service accounts final edited.png

If the Service Accounts section is not visible, then select Edit Tabs, drag the Service Accounts section onto your preferred position on the screen and then return to Login Config.

edit tabs.jpg

Once the Service Account section is available, click on Add Service Account.

We recommend using ConnecttoAD for both your Username and External ID to make them easily recognizable. 

Set your Password, select the custom Security Profile you created for Connect to AD, an Account Group that has access to all the employees we need to sync and save the service account.

Your UKG Ready Service Account is now ready. Please, take note of the Username, Password and External ID before moving on to the next section.



Step 2 - Collecting Additional Information

Before leaving the Login Config tab, let’s grab the REST API Key.  Click on the eye-shaped icon to make it visible or on the GENERATE button to create a new one if the key is not present. Copy and paste it somewhere safe as we will need it later.

From here, navigate to the Company Info tab, then scroll down to the Company Address section and take note of the Company Short Name.

Lastly, we will need to get the Host Domain. To do that, simply copy and paste the base URL your browser shows while you are in UKG Ready.

host from url.png

By this point, we should have gathered the following information:

  • User Name
  • Password
  • External ID
  • REST API Key
  • Company Short Name
  • Host Domain

Please, make sure to have these on hand before moving on to the next section.


If you wish to create a specific Connect to AD Security Profile, please follow the instructions in this article before moving on to the next section.



Step 3 - Create a Saved Report for Connect to AD

We will now move on to creating a Saved Report, which will act as the data source for Connect to AD.

To do so, navigate to My Info > My Reports > Reports Hub > Overview > Build Report

Follow the instructions to create an Employee Information report and save it.

The name of the report is not too important, but we suggest using something immediately recognizable such as Connect to AD Source Report or similar. We also suggest adding a quick description along the lines of “This report is designed specifically for Connect to AD - Please do not modify this report or your UKG to Active Directory sync might stop working”

Navigate to My Saved Reports and click Edit on your newly created report.

When we edit the Saved Report, we need to make sure that the report is shared with the service account, or Connect to AD will not be able to access it. We do this by enabling the Share checkbox and then selecting Share with others > Browse Service account. From here, select the previously created Connect to AD service account you created and save. This is fundamental for Connect to AD to work. 

Save your report and make a note of the System ID before moving on to the next section.

Step 4 - Configure the Saved Report

Navigate to My Info > My Reports > Reports Hub >  My Saved Reports and select the Connect to AD report.

We now need to include all the UKG Ready columns that we need to sync over to Active Directory as well as some required fields we will explore later.

Each report column holds the UKG Ready field for Connect to AD to read. 

To add or remove columns click on the ellipsis (three-dots) button in the upper right corner of the report and select Add/Remove Columns

Connect to AD does require that you do include the Employee Id, Account Id and Employee Status columns, so be sure to include those, then select all the columns you need to have in the report and Apply to save the changes.


A correctly setup report is key to a successful sync. Before proceeding to the next step, please refer to this article to confirm all of your chosen columns are following the correct naming convention.

We are now ready to configure Connect to AD UKG Ready connection.



Step 5 - Setup the UKG Ready Connection in Connect to AD

Open Connect to AD, select the  + icon to create a new environment, select UKG Ready from the Source drop down menu and click Next.

add new environment.png

new environment type.png

Navigate to UKG Ready Connection, enter the data we have collected so far in the requested fields and then click on the Check Connection icon to test the connection between Connect to AD and UKG Ready.

If the connection is successful, you should see something similar to the image below:

check ukg connection.png

If the connection has failed, please confirm that you have entered your UKG Ready values correctly (check for leading and trailing spaces) and try again.

If you are still unable to establish a good connection, please reach out to our support team at


Get assistance via a support ticket

Submit a Support Ticket


Access learning resources and discuss all things Connect to AD with other merchants.

Get Help from the Community


View the the product documents to learn more about how to use Connect to AD.

Read the Docs

Frequently Asked Questions

Find answers to frequently asked questions

Frequently Asked Questions