> ## Documentation Index > Fetch the complete documentation index at: https://stackone-hub-docs-confluence-api-token-update.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # UKG Ready (OAuth Client Credentials) > Follow these steps to connect UKG Ready (OAuth Client Credentials) with StackOne Hub successfully. Ensure you have Admin privileges for your UKG Ready account. If you've been directed to StackOne to integrate with UKG Ready (OAuth Client Credentials), the following steps will help you understand the process and any necessary actions to configure successful integration. ## Getting your UKG Ready URL and Company Short Name 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. UKG Ready URL Click `≡` at the top-left corner. Company Setup Navigate to `Settings` > `Global Setup` global setup then `Global Setup` > `Company Setup` global setup 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` Company info Company Short Name ## Enabling OAuth Applications in your dashboard 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`. edit tabs tab If you don't already see `OAuth Applications` in the column view - then from the `Available Windows` section look for `OAuth Applications` edit tabs tab Drag it into a column of your choice under the `Login Config` tab. edit tabs tab Once you're happy with the view - click `Save` and navigate back to the `Company Setup` view. edit tabs tab ## Generating OAuth Client Credentials Under *Company Setup* on the `Login Config` tab, login config Find `OAuth Applications` and click `Add OAuth Application` OAuth Application 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). Account Groups - System Group Selection Click `≡` at the top-left corner. Company Setup Navigate to the `Profiles/Policies` > `Security`, then click on `NEW SECURITY PROFILE` to create one, new scurity profile Enter the `Name`, `Description` (optional) and check `Active` field, then click on `Save` button. new scurity profile form Under the `Security Items`, Navigate to following tabs to mark the permissions: `Global` tab * Global Setup * Cost Center Definitions (View/Edit/Add) * Cost Center Trees (View/Edit) global_setup_2 * Object Lists * Cost Centers (View/Edit/Add) object_list_1 `HR` tab * Employee Management * Base Compensation (View/Edit) * Benefit Management (Plans) (View/Edit) * Cost Centers (View/Edit) * Demographics (View/Edit) * HR Custom Values (View/Edit) employee_manag_1 * Position Management * Positions (View/Edit/Add) position_1 `Modules` tab * REST API Resources * Employee Demographics (View/Edit) * Employee HR Custom Fields (View/Edit) * Employee Pay Information (View/Edit) * Employee Profiles (View/Edit) * Employees (View/Edit/Add) * Employees (Changed) (View) rest_resources_1 Click on `Save` to save security profile changes, save_security_profile login config 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. security_profiles_lookup Once you're happy with the configuration - click the `Save` button. ## Job Change Reason Codes UKG Ready (OAuth Client Credentials) requires a Job Change Reason Code when assigning a job to a new hire or changing an employee's job. At least one of these fields is required if employee jobs will be assigned via this connection. Click `≡` at the top-left corner. Company Setup Navigate to `Settings > HR Setup > Company Setup > Job Change Reason Codes` global setup 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. global setup 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. Enter Credentials
Congratulations, you're all set! If you face any issues with the steps mentioned above, please contact us by emailing [integrations@stackone.com](mailto:integrations@stackone.com). We're always here to assist you! ## Useful Links [https://library.ukg.com/ukg-ready](https://library.ukg.com/ukg-ready)