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

# HighLevel

> Choose where to install the HighLevel app, then approve access.

## Before users connect: create the marketplace app

<Steps>
  <Step title="Open the app dashboard">
    Sign into the [HighLevel Marketplace](https://marketplace.gohighlevel.com/). Open **App dashboard** or **My apps**, then select **Create app**.

    <img src="https://mintcdn.com/rollout/geMrLesykrIZRu6I/images/end-user-guides/highlevel/app-dashboard.png?fit=max&auto=format&n=geMrLesykrIZRu6I&q=85&s=b9adebbb5c6792a538ca34bd68c6e07d" alt="HighLevel Marketplace App dashboard with My apps and Create app highlighted by their placement in the interface" width="1450" height="190" data-path="images/end-user-guides/highlevel/app-dashboard.png" />
  </Step>

  <Step title="Choose the app type and target user">
    Name the app after the product you are connecting and select **Public**.

    Under **Who is the target user of the app?**, choose:

    * **Sub-Account** for an app that connects one location.
    * **Agency** for an agency-level app that can manage multiple locations.

    Keep the recommended installation and listing options unless your distribution requirements differ. If you support both connection types, create a separate app for each target user because Rollout uses separate OAuth credentials for Agency and Sub-Account connections.

    <img src="https://mintcdn.com/rollout/geMrLesykrIZRu6I/images/end-user-guides/highlevel/create-app.png?fit=max&auto=format&n=geMrLesykrIZRu6I&q=85&s=e4093d9e816185d50fd711dec5fd4a82" alt="HighLevel Create an app form showing Public app, Sub-Account or Agency target user, installer, and listing type options" width="565" height="705" data-path="images/end-user-guides/highlevel/create-app.png" />
  </Step>

  <Step title="Add the redirect URI and scopes">
    Open the app, expand **Advanced Settings**, and select **Auth**. Add and select this production redirect URI:

    ```text theme={null}
    https://universal.rollout.com/api/oauth/redirect
    ```

    <img src="https://mintcdn.com/rollout/geMrLesykrIZRu6I/images/end-user-guides/highlevel/oauth-redirect-and-scopes.png?fit=max&auto=format&n=geMrLesykrIZRu6I&q=85&s=20d68139c14c3ab394ef1a3584673984" alt="HighLevel Advanced Settings Auth page with the Rollout production redirect URI selected and the scopes area below" width="1599" height="984" data-path="images/end-user-guides/highlevel/oauth-redirect-and-scopes.png" />

    For a **Sub-Account / Location** app, enable:

    ```text theme={null}
    contacts.write contacts.readonly conversations.readonly
    conversations/message.readonly conversations/message.write
    users.readonly users.write opportunities.write opportunities.readonly
    ```

    For an **Agency** app, enable:

    ```text theme={null}
    locations.write locations.readonly conversations.readonly
    conversations/message.readonly conversations/message.write
    contacts.write contacts.readonly users.readonly users.write
    opportunities.write opportunities.readonly oauth.readonly oauth.write
    objects/record.readonly objects/schema.readonly
    associations/relation.write associations/relation.readonly
    ```

    Use the scope search and category controls to select each permission. HighLevel displays the selected-scope count and flags sensitive permissions for review.

    <img src="https://mintcdn.com/rollout/geMrLesykrIZRu6I/images/end-user-guides/highlevel/scopes.png?fit=max&auto=format&n=geMrLesykrIZRu6I&q=85&s=ed02ee2529badd72a464cf22123140bc" alt="HighLevel Auth page showing the scope search, selected-scope count, and sensitive-scope warning" width="1505" height="926" data-path="images/end-user-guides/highlevel/scopes.png" />

    <img src="https://mintcdn.com/rollout/geMrLesykrIZRu6I/images/end-user-guides/highlevel/oauth-scopes.png?fit=max&auto=format&n=geMrLesykrIZRu6I&q=85&s=5e08c7979abf1f10dac355a144b8ba99" alt="HighLevel Auth page showing the selected oauth.write and oauth.readonly scopes" width="925" height="730" data-path="images/end-user-guides/highlevel/oauth-scopes.png" />
  </Step>

  <Step title="Generate the Client ID and Client Secret">
    After the app configuration is saved, expand **Manage** and select **Secrets**. Under **Client keys**, select **Add** to generate a Client ID and Client Secret.

    <img src="https://mintcdn.com/rollout/geMrLesykrIZRu6I/images/end-user-guides/highlevel/client-keys.png?fit=max&auto=format&n=geMrLesykrIZRu6I&q=85&s=c54624cf67024d2e6bfe517bfa7ec83c" alt="HighLevel Manage Secrets page showing the Client keys section and Add button" width="930" height="280" data-path="images/end-user-guides/highlevel/client-keys.png" />

    Copy the Client Secret immediately and store it in your password manager. HighLevel masks saved secrets.

    Enter the Client ID and Client Secret in the matching **Agency** or **Sub-Account** HighLevel OAuth configuration in Rollout. Do not mix credentials from apps with different target-user types.
  </Step>
</Steps>

## Connect a HighLevel account

<Steps>
  <Step title="Choose where to install the app">
    In the connection window, choose an installation scope:

    * Select **Agency** to connect an Agency Pro account and manage its locations.
    * Select **Sub-Account** to connect one location.

    Then select **Connect Account**.

    <div className="hidden sm:block">
      <img src="https://mintcdn.com/rollout/geMrLesykrIZRu6I/images/end-user-guides/highlevel/connect-account.png?fit=max&auto=format&n=geMrLesykrIZRu6I&q=85&s=d7d4c4bc2f1c8d05a459287adb98e4c2" alt="The Rollout-powered HighLevel connection screen with the Agency or Sub-Account selector and Connect Account button" width="1000" height="430" data-path="images/end-user-guides/highlevel/connect-account.png" />
    </div>

    <div className="sm:hidden">
      <img src="https://mintcdn.com/rollout/geMrLesykrIZRu6I/images/end-user-guides/highlevel/connect-account-mobile.png?fit=max&auto=format&n=geMrLesykrIZRu6I&q=85&s=8a2cb8cefa1f2df6f6ab972aac989928" alt="A mobile close-up of the HighLevel installation scope selector and Connect Account button" width="900" height="387" data-path="images/end-user-guides/highlevel/connect-account-mobile.png" />
    </div>
  </Step>

  <Step title="Sign into HighLevel">
    In the secure HighLevel window that opens, sign in with the account you want to connect.
  </Step>

  <Step title="Choose the account and approve access">
    Choose the agency or sub-account requested in the first step, review the permissions, then approve the connection.

    The window closes and returns you to the product. Your HighLevel account is now connected.
  </Step>
</Steps>
