> ## Documentation Index > Fetch the complete documentation index at: https://hub.stackone.com/llms.txt > Use this file to discover all available pages before exploring further. # UKG Ready (OAuth) > Follow these steps to connect UKG Ready (OAuth) with StackOne Hub successfully. > [!WARNING] > > Ensure you have Admin privileges for your UKG Ready account. If you've been directed to StackOne to integrate with UKG Ready (OAuth), 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 **1. 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. ![UKG Ready URL](https://mintcdn.com/stackone-hub/u5avwiCuI3UqGcSZ/images/ukgready/image6.png?fit=max\&auto=format\&n=u5avwiCuI3UqGcSZ\&q=85\&s=7bbb74e3a9a3c199b7177f13f7324ace) **2. Navigate to Company Setup** Click `≡` at the top-left corner. ![Company Setup](https://mintcdn.com/stackone-hub/iZWSHb259O17akRl/images/ukgready/image1.png?fit=max\&auto=format\&n=iZWSHb259O17akRl\&q=85\&s=650ef3580ef689b0185069ad549289d2) Navigate to `Settings` > `Global Setup` ![global setup](https://mintcdn.com/stackone-hub/u5avwiCuI3UqGcSZ/images/ukgready/image2.png?fit=max\&auto=format\&n=u5avwiCuI3UqGcSZ\&q=85\&s=b9d28e937ab9004e89b95fa8edcf74d0) then `Global Setup` > `Company Setup` ![global setup](https://mintcdn.com/stackone-hub/u5avwiCuI3UqGcSZ/images/ukgready/image3.png?fit=max\&auto=format\&n=u5avwiCuI3UqGcSZ\&q=85\&s=4dc1b6f9aff0fed23aeb544a98d8c24f) **3. 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` ![Company info](https://mintcdn.com/stackone-hub/u5avwiCuI3UqGcSZ/images/ukgready/image4.png?fit=max\&auto=format\&n=u5avwiCuI3UqGcSZ\&q=85\&s=23baa535d9285a42a826cd40feae3301) ![Company Short Name](https://mintcdn.com/stackone-hub/u5avwiCuI3UqGcSZ/images/ukgready/image5.png?fit=max\&auto=format\&n=u5avwiCuI3UqGcSZ\&q=85\&s=c7e0d1fd25325b6d40a935f3700aca42) ## Enabling OAuth Applications in your dashboard **1. 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`. ![edit tabs tab](https://mintcdn.com/stackone-hub/u5avwiCuI3UqGcSZ/images/ukgready/image7.png?fit=max\&auto=format\&n=u5avwiCuI3UqGcSZ\&q=85\&s=ff26e56253f3f3e405ac66ce498b39ec) 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](https://mintcdn.com/stackone-hub/u5avwiCuI3UqGcSZ/images/ukgready/image8.png?fit=max\&auto=format\&n=u5avwiCuI3UqGcSZ\&q=85\&s=1c5e494a88f9fd297066dc3598b05aa4) Drag it into a column of your choice under the `Login Config` tab. ![edit tabs tab](https://mintcdn.com/stackone-hub/iZWSHb259O17akRl/images/ukgready/image10.png?fit=max\&auto=format\&n=iZWSHb259O17akRl\&q=85\&s=7d259962d036bb49b1aa37f15d795970) Once you're happy with the view - click `Save` and navigate back to the `Company Setup` view. ![edit tabs tab](https://mintcdn.com/stackone-hub/iZWSHb259O17akRl/images/ukgready/image11.png?fit=max\&auto=format\&n=iZWSHb259O17akRl\&q=85\&s=4c22359c8dc2c60462aad191935417e5) ## Generating OAuth Credentials **1. Add OAuth Application** Under *Company Setup* on the `Login Config` tab, ![login config](https://mintcdn.com/stackone-hub/iZWSHb259O17akRl/images/ukgready/image12.png?fit=max\&auto=format\&n=iZWSHb259O17akRl\&q=85\&s=c46fa5270bf227a32bb6d905d4df7346) Find `OAuth Applications` and click `Add OAuth Application` ![OAuth Application](https://mintcdn.com/stackone-hub/iZWSHb259O17akRl/images/ukgready/image13.png?fit=max\&auto=format\&n=iZWSHb259O17akRl\&q=85\&s=2870b3b146f9638a2222f77e5199a64d) **2. Generate OAuth Credentials** Enter the following field values: * **Name:** Enter a name for this new OAuth application * **Application Type:** Select `Interactive` * **Client Id:** Generated automatically * **Redirect URL:** `https://api.stackone.com/connect/oauth2/ukgready/callback` ![login config](https://mintcdn.com/stackone-hub/iZWSHb259O17akRl/images/ukgready/image14.png?fit=max\&auto=format\&n=iZWSHb259O17akRl\&q=85\&s=e2e0754bc9135dcd8824d8d225e60e0d) Once you're happy with the configuration - click the `Save` button. ## Job Change Reason Codes > [!NOTE] > > UKG Ready (OAuth) 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. **1. Navigate to Job Change Reason Code** Click `≡` at the top-left corner. ![Company Setup](https://mintcdn.com/stackone-hub/iZWSHb259O17akRl/images/ukgready/image1.png?fit=max\&auto=format\&n=iZWSHb259O17akRl\&q=85\&s=650ef3580ef689b0185069ad549289d2) Navigate to `Settings > HR Setup > Company Setup > Job Change Reason Codes` ![global setup](https://mintcdn.com/stackone-hub/u5avwiCuI3UqGcSZ/images/ukgready/image16.png?fit=max\&auto=format\&n=u5avwiCuI3UqGcSZ\&q=85\&s=32ce9e2a31d85008b9c8af8bbed13fab) **2. 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 - New Hire** field, we recommend using a code of Type `New Hire`. * **Job Change Reason Code - Other** 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](https://mintcdn.com/stackone-hub/iZWSHb259O17akRl/images/ukgready/image-18.png?fit=max\&auto=format\&n=iZWSHb259O17akRl\&q=85\&s=48b993b7bd4adfc09813ca796fbe014f) Copy the **Name** of each code you wish to use. ## Connecting with StackOne **1. Connecting with StackOne** Upon reaching the Link Account page, enter the following credentials: * UKG Ready URL * Client ID * Company Short Name * Job Change Reason Code - New Hire (optional) * Job Change Reason Code - Other (optional) Proceed by clicking the `Connect` button. ![Enter Credentials](https://mintcdn.com/stackone-hub/iZWSHb259O17akRl/images/ukgready/image-19.png?fit=max\&auto=format\&n=iZWSHb259O17akRl\&q=85\&s=2d1f4f15646f9fadb23e604f0b0a3cc3) ## Useful Links > **[API Reference](https://library.ukg.com/ukg-ready)** > > [https://library.ukg.com/ukg-ready](https://library.ukg.com/ukg-ready) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.