UKG Ready (OAuth Client Credentials)

Login to UKG Ready dashboard

Once logged in, copy your UKG Ready URL from the address bar, ending with .rdy.ukg.dev. Store this to be used in a later step.

Navigate to Company Setup

Click ≡ at the top-left corner.

Navigate to Settings > Global Setup

then Global Setup > Company Setup

Copy Company Short Name

Under Company Setup > Company Info, scroll down to the Company Address section and copy the Company Short Name. If it is not available in that section, please enter the Company Short Name and click Save

Enable OAuth Applications

The option to generate OAuth credentials may not be available by default, and must be enabled to support this connection. Under Company Setup Navigate to Edit Tabs.

If you don’t already see OAuth Applications in the column view - then from the Available Windows section look for OAuth Applications

Drag it into a column of your choice under the Login Config tab.

Once you’re happy with the view - click Save and navigate back to the Company Setup view.

Add OAuth Application

Under Company Setup on the Login Config tab,

Find OAuth Applications and click Add OAuth Application

Generate OAuth Client Credentials

Enter the following field values:

• Name: Enter a name for this new OAuth application
• Application Type: Select Machine to Machine
• Client Id: Generated Automatically
• Secret: Click on the GENERATE SECRET button
• Security Profile: Select a Security Profile within your UKG Ready instance that has permissions for all of the data you wish for this integration to read and/or modify.
• Account Groups: Click on the List Group icon to select one of the groups that has been assigned the required permissions.
  • Select the “System” group type called “All Company Employees” (this is a built-in, non-editable group that includes all company employees).
    

Permissions required within the Security Profile

Click on the List Security Profile icon. Your added security profile will be displayed in the Security Profiles Lookup grid for selection. Click on the 🏳️ icon to choose it.

Once you’re happy with the configuration - click the Save button.

Navigate to Job Change Reason Code

Click ≡ at the top-left corner.

Navigate to Settings > HR Setup > Company Setup > Job Change Reason Codes

Copy Job Change Reason Code

The existing codes for your company will be displayed here. For the following fields on the connector hub form,

• Job Change Reason Code - Employee Create field, we recommend using a code of Type New Hire.
• Job Change Reason Code - Employee Update field, we recommend using a code of Type Other.

You can create a new code by clicking the ADD NEW button in the top-right.

Copy the Name of each code you wish to use.

Connecting with StackOne

Upon reaching the Link Account page, enter the following credentials:

• UKG Ready URL
• Client ID
• Client Secret
• Company Short Name
• Job Change Reason Code - Employee Create (optional)
• Job Change Reason Code - Employee Update (optional)

Proceed by clicking the Connect button.