> ## 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)

> 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-docs-confluence-api-token-update/_BEMwWcX5HRLBXL3/images/ukgready/image6.png?fit=max&auto=format&n=_BEMwWcX5HRLBXL3&q=85&s=1358cfeb8b4c70dc8201c31dcc426da9" 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-docs-confluence-api-token-update/_BEMwWcX5HRLBXL3/images/ukgready/image1.png?fit=max&auto=format&n=_BEMwWcX5HRLBXL3&q=85&s=577a5f73db45c3a55ed775f4255cd568" 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-docs-confluence-api-token-update/_BEMwWcX5HRLBXL3/images/ukgready/image2.png?fit=max&auto=format&n=_BEMwWcX5HRLBXL3&q=85&s=37c3ecc0a0bdeb42adde6d22447b9d0e" 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-docs-confluence-api-token-update/_BEMwWcX5HRLBXL3/images/ukgready/image3.png?fit=max&auto=format&n=_BEMwWcX5HRLBXL3&q=85&s=ddd2e300db8796f0df0b66f866d207c8" 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-docs-confluence-api-token-update/_BEMwWcX5HRLBXL3/images/ukgready/image4.png?fit=max&auto=format&n=_BEMwWcX5HRLBXL3&q=85&s=7309a3dc67b0670f83b5676ba6da6ae5" 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-docs-confluence-api-token-update/_BEMwWcX5HRLBXL3/images/ukgready/image5.png?fit=max&auto=format&n=_BEMwWcX5HRLBXL3&q=85&s=025dac9064bba01d2d1f93bdd116f0fc" 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-docs-confluence-api-token-update/_BEMwWcX5HRLBXL3/images/ukgready/image7.png?fit=max&auto=format&n=_BEMwWcX5HRLBXL3&q=85&s=4e4bf63b5d56fd7926939d6f11bf6c59" 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-docs-confluence-api-token-update/_BEMwWcX5HRLBXL3/images/ukgready/image8.png?fit=max&auto=format&n=_BEMwWcX5HRLBXL3&q=85&s=0757ddb9d7ec2f800072d51012f6f43b" 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-docs-confluence-api-token-update/_BEMwWcX5HRLBXL3/images/ukgready/image10.png?fit=max&auto=format&n=_BEMwWcX5HRLBXL3&q=85&s=0a10e871e2398024452c63fb1899b5b0" 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-docs-confluence-api-token-update/_BEMwWcX5HRLBXL3/images/ukgready/image11.png?fit=max&auto=format&n=_BEMwWcX5HRLBXL3&q=85&s=320521c1222623f66b8e9d3c75e0fa8c" 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-docs-confluence-api-token-update/_BEMwWcX5HRLBXL3/images/ukgready/image12.png?fit=max&auto=format&n=_BEMwWcX5HRLBXL3&q=85&s=b2a540b8135fcae89acd4647b3b989d9" 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-docs-confluence-api-token-update/_BEMwWcX5HRLBXL3/images/ukgready/image13.png?fit=max&auto=format&n=_BEMwWcX5HRLBXL3&q=85&s=332225077b73341dd818617211e8daaf" 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-docs-confluence-api-token-update/_BEMwWcX5HRLBXL3/images/ukgready/image14.png?fit=max&auto=format&n=_BEMwWcX5HRLBXL3&q=85&s=32b6ff2eff3e41c92300987786e6380e" 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-docs-confluence-api-token-update/_BEMwWcX5HRLBXL3/images/ukgready/image1.png?fit=max&auto=format&n=_BEMwWcX5HRLBXL3&q=85&s=577a5f73db45c3a55ed775f4255cd568" 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-docs-confluence-api-token-update/_BEMwWcX5HRLBXL3/images/ukgready/image16.png?fit=max&auto=format&n=_BEMwWcX5HRLBXL3&q=85&s=8e7e8aca3442376bd992e2456bfa730b" 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-docs-confluence-api-token-update/_BEMwWcX5HRLBXL3/images/ukgready/image-18.png?fit=max&auto=format&n=_BEMwWcX5HRLBXL3&q=85&s=e1dd1081572cf632fe31ea5a36d7f865" 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-docs-confluence-api-token-update/_BEMwWcX5HRLBXL3/images/ukgready/image-19.png?fit=max&auto=format&n=_BEMwWcX5HRLBXL3&q=85&s=74819452983721bfcb363fcca04c2e69" 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>
