> ## 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 absence.io with OAuth 2.0 (Client Credentials) – StackOne Hub

> Link a absence.io account in the StackOne Hub using OAuth 2.0 (Client Credentials). End-user guide to authorize the integration and start using absence.io actions.

<Warning>Generate the OAuth client from a user whose role grants the permissions you need — the token inherits that user's role. Use an Owner or Admin account for full API coverage; a regular User account will see fewer resources. The Client Secret is shown only once at creation; copy it immediately before navigating away.</Warning>

<section data-guide-section data-guide-scopes="">
  <h2>Generate an OAuth client in absence.io</h2>

  <p>Create a Client ID and Client Secret on the user profile's Integrations tab. The OAuth client lives under your <strong>personal profile</strong> — not under the organization-level Settings > Integrations page.</p>

  <Steps>
    <Step title="Sign in to absence.io">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Sign in to <a href="https://app.absence.io/" target="_blank" rel="noopener noreferrer">absence.io</a> with the account whose role and permissions the token should inherit (Owner / Admin recommended for full access).</p>
      </div>
    </Step>

    <Step title="Open your personal profile">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Click your <strong>user avatar in the top-right</strong> of the app header, then choose <strong>Show Profile</strong> from the dropdown. This opens your personal profile drawer.</p>
      </div>
    </Step>

    <Step title="Open the Integrations tab on your profile">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>In the profile drawer's left sidebar, click <strong>Integrations</strong>. You should see four sections — Calendar Subscription, Slack, API Key, and OAuth.</p>

        <ul>
          <li><strong>Do NOT</strong> confuse this with <strong>Settings > Integrations</strong> in the main app sidebar — that page is for Slack / Microsoft 365 / Google / Okta SSO and does not contain OAuth client creation.</li>
          <li><strong>Do NOT</strong> click <strong>Generate API Key</strong> — that creates a Hawk credential (HMAC signature scheme) which is not used by this connector.</li>
        </ul>
      </div>
    </Step>

    <Step title="Generate the OAuth client">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Scroll to the <strong>OAuth</strong> section on the Integrations tab and click <strong>Generate OAuth client</strong>. absence.io displays the new <strong>Client ID</strong> and <strong>Client Secret</strong>.</p>

        <ul>
          <li>Copy and store both values securely.</li>
          <li>The <strong>Client Secret</strong> is shown only once — save it before closing the dialog or navigating away. There is no way to retrieve it later.</li>
          <li>If the Client Secret is lost, regenerate the credentials: click <strong>Delete OAuth client</strong> to remove the existing client, then click the <strong>Generate OAuth client</strong> button that reappears to create a fresh Client ID and Client Secret.</li>
          <li>If you regenerate the credentials, you must reconnect the account using the newly generated Client ID and Client Secret. The old credentials are invalidated immediately, so any existing connection will stop working and enter an error state until it is reconnected with the new values.</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>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>
