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

# HighLevel OAuth 2.0 connector profile – StackOne setup guide

> Set up the OAuth 2.0 connector profile for HighLevel in StackOne. One-time admin setup required before your users can link HighLevel accounts via Hub.

<section data-guide-section data-guide-scopes="">
  <h2>Create a Marketplace app</h2>

  <p>Register an app in the HighLevel Marketplace and copy its client credentials.</p>

  <Steps>
    <Step title="Create the app">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Sign in at <a href="https://marketplace.gohighlevel.com" target="_blank" rel="noopener noreferrer">marketplace.gohighlevel.com</a>, open <strong>My Apps</strong> and click <strong>Create App</strong>.</p>
      </div>
    </Step>

    <Step title="Choose the distribution type">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Under <strong>Target User</strong>, choose <strong>Agency</strong> to review a whole agency, or <strong>Sub-account</strong> to review one sub-account. Pick the same value in <strong>App Distribution</strong> here. Under <strong>Listing Type</strong>, do not choose <strong>White-label</strong>: HighLevel will not save a redirect URL that mentions HighLevel on a white-label app, and the StackOne redirect URL contains `highlevel`.</p>
      </div>
    </Step>

    <Step title="Add scopes and the redirect URL">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Under <strong>Advanced Settings</strong> > <strong>Auth</strong>, click the <strong>Select Scope</strong> dropdown and add the scopes `users.readonly` and `locations.readonly`, plus `companies.readonly` for an agency app. Enter `https://api.stackone.com/connect/oauth2/highlevel/callback` in the <strong>Redirect URL</strong> field and click <strong>Add</strong> to save it.</p>
      </div>
    </Step>

    <Step title="Copy the credentials">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Under <strong>Manage</strong> > <strong>Secrets</strong>, click <strong>Add</strong> in <strong>Client Keys</strong> and copy the <strong>Client ID</strong> and <strong>Client Secret</strong>.</p>

        <ul>
          <li>The Client Secret is shown once. Copy and store it immediately; HighLevel will not show it again.</li>
        </ul>
      </div>
    </Step>
  </Steps>
</section>

## Creating the StackOne Connector Profile

To create the Connector Profile in StackOne for <strong>HighLevel</strong>:

<Steps>
  <Step title="Navigate to Connector Profiles">
    Login to StackOne and navigate to [Connector Profiles](https://app.stackone.com/connector_profiles)
  </Step>

  <Step title="Create New Connector Profile">
    <ul>
      <li>Click <strong>+ Connector Profile</strong></li>
      <li>Search for and select <strong>HighLevel</strong></li>
      <li>Select <strong>Type</strong> as <strong>OAuth 2.0</strong></li>

      <li>
        Fill out the fields using details retrieved from your provider:

        <ul className="connector-guide-field-list">
          <li><strong>Client ID</strong></li>
          <li><strong>Client Secret</strong></li>
          <li><strong>App Distribution</strong></li>
          <li><strong>Scopes</strong> (Optional)</li>
        </ul>
      </li>

      <li>(Optional) Select <strong>Actions</strong> to be enabled for this Connector Profile</li>
      <li>Click <strong>Create profile</strong></li>
    </ul>
  </Step>
</Steps>

Congratulations! The new Connector Profile will now show up in your project ready to be used. You can now continue to <a href="/connect/managing-connectors/linking-accounts">Link Accounts</a> for <strong>HighLevel</strong>.
