> ## 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 CezanneHR with OAuth 2.0 – StackOne Hub

> Link a CezanneHR account in the StackOne Hub using OAuth 2.0. End-user guide to authorize the integration and start using CezanneHR actions.

<Warning>Admin privileges are required for your CezanneHR account.</Warning>

<section data-guide-section data-guide-scopes="">
  <h2>Obtain Your Subdomain</h2>

  <p>Locate the subdomain from your CezanneHR account URL.</p>

  <Steps>
    <Step title="Identify Your Subdomain">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Find the portion of your URL appearing before `.cezanneondemand.com` and after `https://`.</p>

        <ul>
          <li>Format: `https://{subdomain}.cezanneondemand.com`</li>
          <li>Example: If your URL is `https://w3.cezanneondemand.com`, your subdomain is `w3`</li>
        </ul>
      </div>
    </Step>
  </Steps>
</section>

<section data-guide-section data-guide-scopes="">
  <h2>Create an Application</h2>

  <p>Create an authorised application in CezanneHR to obtain your API credentials.</p>

  <Steps>
    <Step title="Access Authorised Applications">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Sign into your <a href="https://www.cezanneondemand.com" target="_blank" rel="noopener noreferrer">CezanneHR account</a> and navigate to <strong>Administration</strong> > <strong>Security Settings</strong> > <strong>Authorised Applications</strong>.</p>
      </div>
    </Step>

    <Step title="Add New Application">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Click <strong>Add New</strong> to create a new application.</p>

        <ul>
          <li>Enter a Name and Description for the application</li>
          <li>Click <strong>Ok</strong></li>
        </ul>
      </div>
    </Step>

    <Step title="Configure Application Settings">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Configure the application permissions, service account, and callback URL.</p>

        <ul>
          <li>Select a <strong>Service Account User</strong></li>
          <li>Check the <strong>Enable All Users</strong> checkbox to permit any service user authentication (optional)</li>
          <li>In the Application Scopes section, enable <strong>Token Information</strong> (required for authentication)</li>
          <li>Enable <strong>API Read Access</strong> (required for data retrieval)</li>
          <li>In the <strong>Allowed Callbacks</strong> field, enter: `https://api.stackone.com/connect/oauth2/cezannehr/callback`</li>
        </ul>
      </div>
    </Step>

    <Step title="Save and Record Credentials">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Click <strong>Save</strong> and note the <strong>Client ID</strong> and <strong>Client Secret</strong> displayed. Store these securely for use later.</p>
      </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>Subdomain</strong></li>
        <li><strong>Client ID</strong></li>
        <li><strong>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>