Skip to main content
The HoopAI App Marketplace lets developers build and distribute integrations to all HoopAI users. Marketplace apps use OAuth 2.0 for authentication and can monetize through subscription billing.

​
App types

TypeDescriptionUse case
Integration appConnects HoopAI with an external serviceCRM sync, payment processor, analytics
Workflow actionAdds custom actions to the Workflow BuilderCustom API calls, data enrichment
Custom pageEmbeds a UI inside HoopAI via iframeDashboards, custom tools
WidgetAdds UI elements to specific areas of HoopAIContact sidebar widgets, dashboard widgets

​
Building your app

1

Register on the Developer Marketplace

Go to marketplace.gohighlevel.com and create a developer account.
2

Create a new app

Click Create App and configure:
  • App name and description
  • OAuth redirect URI
  • Required scopes
  • Webhook subscriptions
3

Implement OAuth flow

Follow the Authentication guide to implement the OAuth 2.0 Authorization Code flow.
4

Build your integration

Use the API Reference to implement your app’s features. Handle token refresh, webhooks, and error cases.
5

Test with a sandbox account

Install your app on a test account and verify all features work correctly.
6

Submit for review

Once tested, submit your app for review. The HoopAI team will verify it meets marketplace standards.

​
App lifecycle events

When your app is installed or uninstalled, HoopAI sends webhook events:
EventWhen it fires
AppInstallA user installs your app on a account
AppUninstallA user removes your app from a account
Handle these events to provision or clean up resources for each installation.

​
Monetization

Marketplace apps can charge users through the External Billing system:
  • Set a monthly or annual subscription price
  • HoopAI handles billing and payments
  • You receive payouts minus the marketplace commission
See the External Billing guide for implementation details.

​
Custom menus and UI

Apps can inject custom navigation items and pages into HoopAI: 
{
  "locationId": "LOC_ID",
  "name": "My App Dashboard",
  "url": "https://myapp.com/dashboard?locationId={{locationId}}",
  "icon": "chart-bar",
  "showInSidebar": true
}
Use the Custom Menus API to manage your app’s navigation entries.

​
Best practices

When a user installs your app, set up all necessary resources (database records, webhook subscriptions) and provide a clear onboarding experience.
Design your app to work within rate limits. Use caching and batch operations where possible.
When your app is uninstalled, clean up webhooks, revoke tokens, and remove any data you no longer need.
Include setup instructions, feature descriptions, and support contact information in your marketplace listing.

​
Next steps

OAuth scopes

Choose the right permissions for your app

Webhook events

Subscribe to platform events
Last modified on March 5, 2026