> ## 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 Docebo with OAuth 2.0 (Password Grant) – StackOne Hub

> Link a Docebo account in the StackOne Hub using OAuth 2.0 (Password Grant). End-user guide to authorize the integration and start using Docebo actions.

<Warning>Administrator privileges in Docebo are required to create OAuth2 apps and manage API credentials.</Warning>

<section data-guide-section data-guide-scopes="">
  <h2>Create Integrations App</h2>

  <p>Create and configure an OAuth2 application in Docebo to obtain your credentials.</p>

  <Steps>
    <Step title="Sign in to Docebo">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Sign in to your Docebo account (e.g., `https://<your-subdomain>.docebosaas.com/learn`) with administrator privileges.</p>
      </div>
    </Step>

    <Step title="Navigate to API and SSO">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Access the API management section.</p>

        <ul>
          <li>Click on <strong>Admin Menu</strong> in the top right corner</li>
          <li>Select <strong>Manage</strong> under <strong>API AND SSO</strong></li>
        </ul>
      </div>
    </Step>

    <Step title="Add OAuth App">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Configure a new authentication app.</p>

        <ul>
          <li>From the API and SSO menu on the left, select <strong>API Credentials</strong></li>
          <li>Click <strong>Add OAuth2 App</strong> to create a new authentication app</li>
        </ul>
      </div>
    </Step>

    <Step title="Create a New OAuth App">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Fill in the OAuth app configuration details.</p>

        <ul>
          <li>Enter the <strong>App Name</strong> (e.g., "StackOne Integration")</li>
          <li>Enter a <strong>Client ID</strong> for the application (required field), then copy it for use in the next steps</li>
          <li>Enter a <strong>Description</strong> for reference</li>
          <li>Enter the <strong>Redirect URI</strong>: `https://api.stackone.com/connect/oauth2/docebo/callback`</li>
          <li>Enable the <strong>Show advanced settings</strong> checkbox to reveal the <strong>Grant Types</strong> options</li>
          <li>Select <strong>Resource Owner Password Credentials</strong> under <strong>Grant Types</strong></li>
          <li>Record the <strong>Client ID</strong> and <strong>Client Secret</strong> for use in the next steps</li>
          <li>Click <strong>Confirm</strong> to save</li>
        </ul>
      </div>
    </Step>

    <Step title="Enable the OAuth App">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Activate your OAuth application.</p>

        <ul>
          <li>Enable the OAuth app by clicking the <strong>green tick icon</strong> next to your app</li>
        </ul>
      </div>
    </Step>
  </Steps>
</section>

<section data-guide-section data-guide-scopes="">
  <h2>Find Domain</h2>

  <p>Locate your Docebo subdomain from the platform URL.</p>

  <Steps>
    <Step title="Identify Your Subdomain">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Extract the subdomain from your Docebo URL.</p>

        <ul>
          <li>Look at the URL in your browser address bar when logged into Docebo</li>
          <li>Take the part before `.docebosaas.com` and after `https://`</li>
          <li>E.g., if your URL is `https://my-domain.docebosaas.com`, the subdomain is `my-domain`</li>
        </ul>
      </div>
    </Step>
  </Steps>
</section>

<section data-guide-section data-guide-scopes="">
  <h2>Configure API User</h2>

  <p>Set up a user account with API access privileges for password grant authentication.</p>

  <Steps>
    <Step title="Create or Identify an API User">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>You need a Docebo user account to authenticate API requests.</p>

        <ul>
          <li>You can use an existing administrator account or create a dedicated API user</li>
          <li>To create a new user, go to <strong>Admin Menu</strong> > <strong>Users</strong>, click the <strong>+</strong> (New users/branch) button, then select <strong>New user</strong></li>
          <li>Ensure the user has <strong>Power User</strong> or <strong>Superadmin</strong> level access for full API functionality</li>
        </ul>
      </div>
    </Step>

    <Step title="Note User Credentials">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Record the username and password for the API user.</p>

        <ul>
          <li>Use the Docebo <strong>Username</strong> (not email address) for the API user</li>
          <li>The username is displayed in the user profile or user management section</li>
          <li>Keep the password secure - this will be used for OAuth2 password grant authentication</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>
        <li><strong>Subdomain</strong></li>
        <li><strong>Username</strong></li>
        <li><strong>Password</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>
