> ## Documentation Index
> Fetch the complete documentation index at: https://stackone-hub-claude-issue-384-20260409-1436.mintlify.site/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.
</Warning>

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

<Steps>
  <Step title="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.

    <Frame>
      <img className="rounded-md" style={{ margin:"0 auto",border:"1px solid #efefef" }} alt="UKG Ready URL" src="https://mintcdn.com/stackone-hub-claude-issue-384-20260409-1436/g-vBLWbgD2nDYbPA/images/ukgready/image6.png?fit=max&auto=format&n=g-vBLWbgD2nDYbPA&q=85&s=19319a87ada7b93d80d7c0f2c40c982a" width="652" height="76" data-path="images/ukgready/image6.png" />
    </Frame>
  </Step>

  <Step title="Navigate to Company Setup">
    Click `≡` at the top-left corner.

    <Frame>
      <img className="rounded-md" style={{ margin:"0 auto",border:"1px solid #efefef" }} alt="Company Setup" src="https://mintcdn.com/stackone-hub-claude-issue-384-20260409-1436/g-vBLWbgD2nDYbPA/images/ukgready/image1.png?fit=max&auto=format&n=g-vBLWbgD2nDYbPA&q=85&s=4618c959ff31ff9e9d3cc62e973b7fec" width="434" height="160" data-path="images/ukgready/image1.png" />
    </Frame>

    Navigate to `Settings` > `Global Setup`

    <Frame>
      <img className="rounded-md" style={{ margin:"0 auto",border:"1px solid #efefef" }} alt="global setup" src="https://mintcdn.com/stackone-hub-claude-issue-384-20260409-1436/g-vBLWbgD2nDYbPA/images/ukgready/image2.png?fit=max&auto=format&n=g-vBLWbgD2nDYbPA&q=85&s=85932657dc003a2532c903c265dc9b71" width="802" height="1160" data-path="images/ukgready/image2.png" />
    </Frame>

    then `Global Setup` > `Company Setup`

    <Frame>
      <img className="rounded-md" style={{ margin:"0 auto",border:"1px solid #efefef" }} alt="global setup" src="https://mintcdn.com/stackone-hub-claude-issue-384-20260409-1436/g-vBLWbgD2nDYbPA/images/ukgready/image3.png?fit=max&auto=format&n=g-vBLWbgD2nDYbPA&q=85&s=8d85797e019ca43c927eee4a64e6c21c" width="800" height="974" data-path="images/ukgready/image3.png" />
    </Frame>
  </Step>

  <Step title="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`

    <Frame>
      <img className="rounded-md" style={{ margin:"0 auto",border:"1px solid #efefef" }} alt="Company info" src="https://mintcdn.com/stackone-hub-claude-issue-384-20260409-1436/g-vBLWbgD2nDYbPA/images/ukgready/image4.png?fit=max&auto=format&n=g-vBLWbgD2nDYbPA&q=85&s=6b2153c740c014b12d6fd4c1596752f9" width="2390" height="456" data-path="images/ukgready/image4.png" />
    </Frame>

    <Frame>
      <img className="rounded-md" style={{ margin:"0 auto",border:"1px solid #efefef" }} alt="Company Short Name" src="https://mintcdn.com/stackone-hub-claude-issue-384-20260409-1436/g-vBLWbgD2nDYbPA/images/ukgready/image5.png?fit=max&auto=format&n=g-vBLWbgD2nDYbPA&q=85&s=f2365faeef36cc1321650e8d2ba65628" width="3450" height="1074" data-path="images/ukgready/image5.png" />
    </Frame>
  </Step>
</Steps>

## Enabling OAuth Applications in your dashboard

<Steps>
  <Step title="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`.

    <Frame>
      <img className="rounded-md" style={{ margin:"0 auto",border:"1px solid #efefef" }} alt="edit tabs tab" src="https://mintcdn.com/stackone-hub-claude-issue-384-20260409-1436/g-vBLWbgD2nDYbPA/images/ukgready/image7.png?fit=max&auto=format&n=g-vBLWbgD2nDYbPA&q=85&s=93ac9ffdc65dfd07e5d30dae49aa5d9f" width="1992" height="378" data-path="images/ukgready/image7.png" />
    </Frame>

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

    <Frame>
      <img className="rounded-md" style={{ margin:"0 auto",border:"1px solid #efefef" }} alt="edit tabs tab" src="https://mintcdn.com/stackone-hub-claude-issue-384-20260409-1436/g-vBLWbgD2nDYbPA/images/ukgready/image8.png?fit=max&auto=format&n=g-vBLWbgD2nDYbPA&q=85&s=96c7d341e00c553a3dfbeed33a684ca9" width="3404" height="1546" data-path="images/ukgready/image8.png" />
    </Frame>

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

    <Frame>
      <img className="rounded-md" style={{ margin:"0 auto",border:"1px solid #efefef" }} alt="edit tabs tab" src="https://mintcdn.com/stackone-hub-claude-issue-384-20260409-1436/g-vBLWbgD2nDYbPA/images/ukgready/image10.png?fit=max&auto=format&n=g-vBLWbgD2nDYbPA&q=85&s=bc58993a4ce402a8ecb1731902312943" width="2684" height="1142" data-path="images/ukgready/image10.png" />
    </Frame>

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

    <Frame>
      <img className="rounded-md" style={{ margin:"0 auto",border:"1px solid #efefef" }} alt="edit tabs tab" src="https://mintcdn.com/stackone-hub-claude-issue-384-20260409-1436/g-vBLWbgD2nDYbPA/images/ukgready/image11.png?fit=max&auto=format&n=g-vBLWbgD2nDYbPA&q=85&s=fd8cc1324c19a18407ce9f7b99f64743" width="3374" height="374" data-path="images/ukgready/image11.png" />
    </Frame>
  </Step>
</Steps>

## Generating OAuth Credentials

<Steps>
  <Step title="Add OAuth Application">
    Under *Company Setup* on the `Login Config` tab,

    <Frame>
      <img className="rounded-md" style={{ margin:"0 auto",border:"1px solid #efefef" }} alt="login config" src="https://mintcdn.com/stackone-hub-claude-issue-384-20260409-1436/g-vBLWbgD2nDYbPA/images/ukgready/image12.png?fit=max&auto=format&n=g-vBLWbgD2nDYbPA&q=85&s=9eefb15bc791e867fa850f7e8ef1e8d8" width="1992" height="378" data-path="images/ukgready/image12.png" />
    </Frame>

    Find `OAuth Applications` and click `Add OAuth Application`

    <Frame>
      <img className="rounded-md" style={{ margin:"0 auto",border:"1px solid #efefef" }} alt="OAuth Application" src="https://mintcdn.com/stackone-hub-claude-issue-384-20260409-1436/g-vBLWbgD2nDYbPA/images/ukgready/image13.png?fit=max&auto=format&n=g-vBLWbgD2nDYbPA&q=85&s=ebea63223bb56507768c3ad71e59daf4" width="1492" height="366" data-path="images/ukgready/image13.png" />
    </Frame>
  </Step>

  <Step title="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`

    <Frame>
      <img className="rounded-md" style={{ margin:"0 auto",border:"1px solid #efefef" }} alt="login config" src="https://mintcdn.com/stackone-hub-claude-issue-384-20260409-1436/g-vBLWbgD2nDYbPA/images/ukgready/image14.png?fit=max&auto=format&n=g-vBLWbgD2nDYbPA&q=85&s=e7d4824b93f1c4a6a9254b9a6034418e" width="1600" height="1428" data-path="images/ukgready/image14.png" />
    </Frame>

    Once you're happy with the configuration - click the `Save` button.
  </Step>
</Steps>

## Job Change Reason Codes

<Info>
  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.
</Info>

<Steps>
  <Step title="Navigate to Job Change Reason Code">
    Click `≡` at the top-left corner.

    <Frame>
      <img className="rounded-md" style={{ margin:"0 auto",border:"1px solid #efefef" }} alt="Company Setup" src="https://mintcdn.com/stackone-hub-claude-issue-384-20260409-1436/g-vBLWbgD2nDYbPA/images/ukgready/image1.png?fit=max&auto=format&n=g-vBLWbgD2nDYbPA&q=85&s=4618c959ff31ff9e9d3cc62e973b7fec" width="434" height="160" data-path="images/ukgready/image1.png" />
    </Frame>

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

    <Frame>
      <img className="rounded-md" style={{ margin:"0 auto",border:"1px solid #efefef" }} alt="global setup" src="https://mintcdn.com/stackone-hub-claude-issue-384-20260409-1436/g-vBLWbgD2nDYbPA/images/ukgready/image16.png?fit=max&auto=format&n=g-vBLWbgD2nDYbPA&q=85&s=c9ce203744c117b2c3e2627d9cdb545b" width="806" height="1632" data-path="images/ukgready/image16.png" />
    </Frame>
  </Step>

  <Step title="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.

    <Frame>
      <img className="rounded-md" style={{ margin:"0 auto",border:"1px solid #efefef" }} alt="global setup" src="https://mintcdn.com/stackone-hub-claude-issue-384-20260409-1436/g-vBLWbgD2nDYbPA/images/ukgready/image-18.png?fit=max&auto=format&n=g-vBLWbgD2nDYbPA&q=85&s=957b8b2d354b1ee9304ce91ac65f4990" width="1240" height="279" data-path="images/ukgready/image-18.png" />
    </Frame>

    Copy the **Name** of each code you wish to use.
  </Step>
</Steps>

## Connecting with StackOne

<Steps>
  <Step title="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.

    <Frame>
      <img className="rounded-md" style={{ margin:"0 auto",border:"1px solid #efefef" }} alt="Enter Credentials" src="https://mintcdn.com/stackone-hub-claude-issue-384-20260409-1436/g-vBLWbgD2nDYbPA/images/ukgready/image-19.png?fit=max&auto=format&n=g-vBLWbgD2nDYbPA&q=85&s=a34c2a9608e3e226c2fac1b637a520e5" width="484" height="774" data-path="images/ukgready/image-19.png" />
    </Frame>
  </Step>
</Steps>

<br />

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

<Card title="API Reference" icon="link" href="https://library.ukg.com/ukg-ready">
  [https://library.ukg.com/ukg-ready](https://library.ukg.com/ukg-ready)
</Card>