Skip to content
App marketplace

Multi-OAuth Support for Marketplace Apps

Learn how Multi-OAuth Support lets GHL Customer Care Marketplace apps connect, manage, refresh, and disconnect multiple external OAuth accounts.

5 min read1,054 words2 explained imagesUpdated Thu, 21 May at 4:34 PM
View as markdownOpen in ClaudeOpen in ChatGPT
Each image has a one line explanation. Switch to full detail for the step it belongs to, the fields and buttons involved, examples and the whole procedure.
On this page
  1. Key Benefits of Multi-OAuth Support
  2. How Multi-OAuth Works
  3. Managing Multiple External Accounts
  4. Setting a Default Connected Account
  5. Disconnecting an External Account
  6. Availability for New and Existing Apps
  7. How To Use Multi-OAuth Support
  8. Frequently Asked Questions
  9. Related Articles

Multi-OAuth Support allows users to connect and manage multiple external accounts for a single Marketplace app installation. This helps agencies, SaaS teams, and sub-account users manage multiple Google, Facebook, SurveyMonkey, CRM, or other OAuth-based accounts without installing duplicate apps or building custom connection workflows. This article explains how Multi-OAuth works, how to manage connected accounts, and where to set or remove external connections.

TABLE OF CONTENTS

What is Multi-OAuth Support for Marketplace Apps?

Multi-OAuth Support allows a single Marketplace app installation to support multiple OAuth connections. Instead of being limited to one connected external account, users can connect more than one account to the same Marketplace app when the app supports Multi-OAuth.

Each connected account can be identified by account name, email, or account ID. GHL Customer Care securely stores and refreshes the connected account tokens, helping apps support more reliable workflows, triggers, and actions across multiple external accounts.

Key Benefits of Multi-OAuth Support

Multi-OAuth Support makes Marketplace apps more flexible for real-world agency and SaaS use cases where users may manage several external accounts.

  • Multiple Account Connections: Connect more than one external OAuth account to a single Marketplace app installation.
  • Cleaner Account Management: View, search, refresh, set default, or disconnect connected accounts from one connection panel.
  • Reduced Manual Work: Avoid duplicate app installations or custom OAuth flows for every external account.
  • Secure Token Handling: GHL Customer Care stores and refreshes OAuth tokens through the platform.
  • Scalable App Workflows: Use multiple connected accounts for workflows, triggers, and actions.
  • Better Agency Support: Manage multiple client, brand, or platform accounts from one Marketplace app.

 How Multi-OAuth Works

Multi-OAuth expands Marketplace apps from a single-connection model to a multi-connection model. This allows one app installation to support several external accounts while keeping each connection separate and identifiable.

Here is how it works:

  1. A user installs a Marketplace app that supports Multi-OAuth.
  2. The user connects one or more external OAuth accounts.
  3. Each connected account appears in the app’s External Connection tab.
  4. GHL Customer Care securely stores and refreshes the connected account tokens.
  5. The app can use those connections for supported workflows, triggers, and actions.

Managing Multiple External Accounts

The External Connection tab is where users can view and manage connected OAuth accounts for a Marketplace app. This makes it easier to confirm which accounts are connected and take action when an account needs to be refreshed, removed, or set as default.

From the External Connection tab, users may be able to:

  • View connected accounts
  • Search connected accounts
  • Add another account
  • Refresh a connection
  • Set a default account
  • Disconnect an account

Setting a Default Connected Account

The default connected account is the account GHL Customer Care uses by default for the app when a default selection is needed. Setting a default helps reduce confusion when multiple external accounts are connected to the same Marketplace app.

To set a default connected account:

  1. Go to App Marketplace.
  2. Open the installed Marketplace app.
  3. Click the External Connection tab.
  4. Locate the account you want to use as the default.
  5. Select the radio button in the Default column.
  6. Confirm the success message that the default account was updated.
Setting a Default Connected Account (image 1 of 2) What this shows Go to App Marketplace. What this shows Illustrates the "Setting a Default Connected Account" section of "Multi-OAuth Support for Marketplace Apps". This screenshot appears in the "Setting a Default Connected Account" section of "Multi-OAuth Support for Marketplace Apps". The text alongside this image reads: Go to App Marketplace. Open the installed Marketplace app. Click the External Connection tab. Locate the account you want to use as the default. Select the radio button in the Default column. Confirm the success message that the default account was updated. Immediately after, the guide continues: Disconnecting an external account removes that OAuth connection from the Marketplace app. This action should only be used when the account is no longer needed or should no longer be available for that app. Image 1 of 2 Where to goGo to App Marketplace. Open the installed Marketplace app. Click the External Connection tab. Locate the account you want to use as the default. Select the radio button in the Default column. Confirm the success message that the default account was updated.
Buttons and menus referenced App MarketplaceExternal ConnectionDefault
Next stepDisconnecting an external account removes that OAuth connection from the Marketplace app. This action should only be used when the account is no longer needed or should no longer be available for that app.
All 6 steps in this procedure
  1. Go to App Marketplace.
  2. Open the installed Marketplace app.
  3. Click the External Connection tab.
  4. Locate the account you want to use as the default.
  5. Select the radio button in the Default column.
  6. Confirm the success message that the default account was updated.

Disconnecting an External Account

Disconnecting an external account removes that OAuth connection from the Marketplace app. This action should only be used when the account is no longer needed or should no longer be available for that app.

To disconnect an external account:

  1. Go to App Marketplace.
  2. Open the installed Marketplace app.
  3. Click the External Connection tab.
  4. Find the connected account you want to remove.
  5. Click the delete icon for that account.
  6. Review the confirmation message.
  7. Click Delete to disconnect the account.
Disconnecting an External Account (image 2 of 2) What this shows Go to App Marketplace. What this shows Illustrates the "Disconnecting an External Account" section of "Multi-OAuth Support for Marketplace Apps". This screenshot appears in the "Disconnecting an External Account" section of "Multi-OAuth Support for Marketplace Apps". The text alongside this image reads: Go to App Marketplace. Open the installed Marketplace app. Click the External Connection tab. Find the connected account you want to remove. Click the delete icon for that account. Review the confirmation message. Click Delete to disconnect the account. Immediately after, the guide continues: Multi-OAuth Support is available for new Marketplace apps or new app versions that support multiple OAuth connections. Existing apps do not automatically gain Multi-OAuth Support unless a new supported version is added. Image 2 of 2 Where to goGo to App Marketplace. Open the installed Marketplace app. Click the External Connection tab. Find the connected account you want to remove. Click the delete icon for that account. Review the confirmation message. Click Delete to disconnect the account.
Buttons and menus referenced App MarketplaceExternal ConnectionDelete
Next stepMulti-OAuth Support is available for new Marketplace apps or new app versions that support multiple OAuth connections. Existing apps do not automatically gain Multi-OAuth Support unless a new supported version is added.
All 7 steps in this procedure
  1. Go to App Marketplace.
  2. Open the installed Marketplace app.
  3. Click the External Connection tab.
  4. Find the connected account you want to remove.
  5. Click the delete icon for that account.
  6. Review the confirmation message.
  7. Click Delete to disconnect the account.

Availability for New and Existing Apps

Multi-OAuth Support is available for new Marketplace apps or new app versions that support multiple OAuth connections. Existing apps do not automatically gain Multi-OAuth Support unless a new supported version is added.

This means:

  • New apps can be built with Multi-OAuth Support.
  • Existing apps may need a new version to support multiple OAuth connections.
  • Users may need to update or reinstall an app version if the developer releases Multi-OAuth Support.
  • Apps that do not support Multi-OAuth may continue to allow only one OAuth connection.

How To Use Multi-OAuth Support

Using Multi-OAuth Support helps ensure each external account is connected, organized, and available for the app’s supported actions. The available options may vary depending on how the Marketplace app was built.

To use Multi-OAuth Support:

  1. Open the sub-account where the Marketplace app is installed.
  2. Go to App Marketplace.
  3. Select the installed app.
  4. Open the External Connection tab.
  5. Click Add Account to connect another external account.
  6. Complete the OAuth authorization flow.
  7. Confirm the new account appears in the connected account list.
  8. Set a default account if needed.
  9. Refresh or disconnect accounts when they need to be updated or removed.

Frequently Asked Questions

Q: What is Multi-OAuth Support?
Multi-OAuth Support allows a single Marketplace app installation to connect and manage multiple external OAuth accounts.

Q: Can I connect more than one external account to the same app?
Yes. When the Marketplace app supports Multi-OAuth, you can connect multiple external accounts from the app’s External Connection tab.

Q: Do existing apps automatically support Multi-OAuth?
No. Multi-OAuth Support is available for new apps or new app versions that support multiple OAuth connections.

Q: Where do I manage connected accounts?
Connected accounts are managed from the installed app’s External Connection tab.

Q: Can I choose which account is used by default?
Yes. You can select a default connected account from the Default column when multiple accounts are connected.

Q: What happens when I disconnect an account?
The selected external account is removed from the app’s connected accounts and can no longer be used by that app unless it is connected again.

Q: Are OAuth tokens refreshed automatically?
Yes. GHL Customer Care securely stores and refreshes connected account tokens through the platform.

Q: Can Multi-OAuth be used for workflows, triggers, and actions?
Yes. Apps can use connected OAuth accounts for supported workflows, triggers, and actions, depending on how the app is built.

Was this guide helpful?

Related guides

API Security - OAuth Consent for Marketplace Apps3 min read · 2 imagesApp Marketplace- Agency Reselling for Apps with Usage-Based Pricing4 min read · 8 imagesApp Marketplace - Agency Control Over Daily Usage Limits for Usage-Based Apps2 min read · 5 imagesWhat is the App Installer Details API?6 min read