> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stackone.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect UKG Ready with OAuth - Client Credentials Grant – StackOne Hub

> Link a UKG Ready account in the StackOne Hub using OAuth - Client Credentials Grant. End-user guide to authorize the integration and start using UKG Ready actions.

<Warning>Ensure you have Admin privileges for your UKG Ready account.</Warning>

<section data-guide-section data-guide-scopes="">
  <h2>Find your UKG Ready URL and Company Short Name</h2>

  <p>Your UKG Ready Base URL and Company Short Name identify your organization's UKG Ready environment.</p>

  <Steps>
    <Step title="Sign in to UKG Ready">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Sign in to your UKG Ready account.</p>

        <ul>
          <li>Your login URL is specific to your organization — contact your administrator or UKG Ready support to obtain it.</li>
          <li>Copy your <strong>UKG Ready Base URL</strong> from the browser address bar — it ends with `.rdy.ukg.dev` or `.saashr.com`. Store it for use later.</li>
        </ul>
      </div>
    </Step>

    <Step title="Navigate to Company Setup">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Click <strong>≡</strong> at the top-left corner.</p>

        <ul>
          <li>Navigate to <strong>Settings</strong> > <strong>Global Setup</strong> > <strong>Company Setup</strong>.</li>
        </ul>
      </div>
    </Step>

    <Step title="Copy Company Short Name">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Under the <strong>Company Info</strong> tab, scroll down to the Company Address section.</p>

        <ul>
          <li>Copy the value in the <strong>Company Short Name</strong> field.</li>
        </ul>
      </div>
    </Step>
  </Steps>
</section>

<section data-guide-section data-guide-scopes="">
  <h2>Enable OAuth Applications</h2>

  <p>The OAuth Applications section must be added to Company Setup before you can create OAuth credentials. Skip this section if <strong>OAuth Applications</strong> is already visible under the <strong>Login Config</strong> tab.</p>

  <Steps>
    <Step title="Open Edit Tabs">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>In <strong>Company Setup</strong>, click <strong>Edit Tabs</strong>.</p>

        <ul>
          <li>In the <strong>Available Windows</strong> section, locate <strong>OAuth Applications</strong>.</li>
          <li>Drag it into a column under the <strong>Login Config</strong> tab.</li>
          <li>Click <strong>Save</strong> and navigate back to <strong>Company Setup</strong>.</li>
        </ul>
      </div>
    </Step>
  </Steps>
</section>

<section data-guide-section data-guide-scopes="">
  <h2>Create a Security Profile</h2>

  <p>A Security Profile defines what data the OAuth application can access. Create one with the permissions required for your integration before generating OAuth credentials.</p>

  <Steps>
    <Step title="Navigate to Security Profiles">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Click <strong>≡</strong> at the top-left corner.</p>

        <ul>
          <li>Navigate to <strong>Profiles/Policies</strong> > <strong>Security</strong>.</li>
          <li>Click <strong>NEW SECURITY PROFILE</strong>.</li>
        </ul>
      </div>
    </Step>

    <Step title="Configure the Security Profile">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Enter a <strong>Name</strong>, optionally a <strong>Description</strong>, and check the <strong>Active</strong> field.</p>

        <ul>
          <li>Under <strong>Security Items</strong>, click <strong>Full Access</strong> to grant all permissions, or select individual permissions based on the data this integration should access.</li>
          <li>Click <strong>Save</strong>.</li>
        </ul>
      </div>
    </Step>
  </Steps>
</section>

<section data-guide-section data-guide-scopes="">
  <h2>Generate OAuth credentials</h2>

  <p>Create a Machine to Machine OAuth application in UKG Ready to obtain your Client ID and Client Secret.</p>

  <Steps>
    <Step title="Open OAuth Applications">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>In <strong>Company Setup</strong>, click the <strong>Login Config</strong> tab.</p>

        <ul>
          <li>Find the <strong>OAuth Applications</strong> section and click <strong>Add OAuth Application</strong>.</li>
        </ul>
      </div>
    </Step>

    <Step title="Configure the OAuth application">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Fill in the application details.</p>

        <ul>
          <li><strong>Name:</strong> Enter a descriptive name (e.g., `StackOne`)</li>
          <li><strong>Application Type:</strong> Select `Machine to Machine`</li>
          <li><strong>Security Profile:</strong> Select the Security Profile you created in the previous section.</li>
          <li><strong>Account Groups:</strong> Click the <strong>List Group</strong> icon and select the <strong>All Company Employees</strong> system group.</li>
          <li>Copy the <strong>Client ID</strong> displayed in the dialog and store it securely for use later.</li>
          <li>Click <strong>GENERATE SECRET</strong> to create the Client Secret — copy it immediately and store it securely for use later, as it is only shown once.</li>
          <li>Click <strong>Save</strong>.</li>
        </ul>
      </div>
    </Step>
  </Steps>
</section>

<div data-whitelabel-hide>
  <h2>Linking the Account from the Hub</h2>

  <Steps>
    <Step title="Navigate to the Hub">
      Use one of the three <a href="/guides/accounts-section#linking-accounts">Linking Account Methods</a> to access the Hub.
    </Step>

    <Step title="Fill out the fields">
      Fill out the following fields using details from your provider:

      <ul>
        <li><strong>UKG Ready Base URL</strong></li>
        <li><strong>Company Short Name</strong></li>
        <li><strong>OAuth Client ID</strong></li>
        <li><strong>OAuth Client Secret</strong></li>
      </ul>
    </Step>

    <Step title="Connect">
      <ul>
        <li>Click <strong>Connect</strong></li>
        <li>If applicable, the provider will redirect you to a sign-in or authorization page. Complete the provider's authorization flow.</li>
        <li>Once authorization is successful, you will see a confirmation popup</li>
      </ul>
    </Step>
  </Steps>

  <p>If the account linking is successful, you will see the newly linked account in your <a href="/guides/accounts-section">Accounts</a> page.</p>
</div>