Home/HighLevel/Features/Developer Resources/Setting up webhooks for your app with HighLevel OAuth V2

Agency, Settings and Integrations

Setting up webhooks for your app with HighLevel OAuth V2

In short

Webhooks let your application receive instant notifications from HighLevel when specific events occur. By configuring OAuth V2, the app can securely obtain an access token and listen for these events. The process involves registering the app, defining scopes, creating redirect and webhook endpoints, and linking locations or accounts.

AreaDeveloper Resources · Developer Resources
Used forMarketing agency, SaaS startup, Appointment booking service
Setup steps14 steps in 1 task
Last updatedNovember 16, 2026

01Who this is for

  • Founders building SaaS integrations need real time lead data to keep their platform in sync with HighLevel.
  • Agency marketers who manage multiple locations require webhook alerts to update contact information across all subaccounts.
  • Developers of appointment booking tools rely on instant booking notifications to trigger calendar actions.

02OAuth API for the CRM Marketplace, explained

The webhook configuration feature enables an app to subscribe to events from HighLevel and receive a JSON payload whenever the event fires. After the OAuth flow exchanges an authorization code for an access token, the app can call the API and the platform posts event data to the app's webhook URL.

These settings are managed in the Developer Marketplace under My Apps. You define the app’s name, keywords, type, distribution, scopes, and the redirect URL that receives the authorization code. A separate POST endpoint receives the webhook payloads. Once locations or accounts are assigned, the app starts receiving events.

The whole workflow lives inside the HighLevel platform’s Developer Resources section, where you register the app, generate credentials, and link the webhook endpoint to specific agency locations or subaccounts.

03How businesses use the OAuth API for the CRM Marketplace

  • Marketing agency. The agency registers a public app, sets the distribution type to Agency, and adds a webhook endpoint that receives new lead events. When a lead is created in any location, the app processes the JSON payload to update the agency’s external system.
  • SaaS startup. The startup creates a private app with Subaccount distribution, defines scopes for contact management, and implements a webhook that captures contact update events. Only the designated subaccount receives the notifications, keeping data isolated.
  • Appointment booking service. The service builds a public app, configures OAuth V2, and points a POST endpoint to its scheduling system. When a user books an appointment in HighLevel, the webhook delivers the event so the service can confirm the slot right away.

04The numbers and rules that matter

  • Private apps are limited to 5 unique Agency installs.

05How to set up and use the OAuth API for the CRM Marketplace in HighLevel

Configure webhooks for your app

  1. Sign up for a developer account at https://marketplace.gohighlevel.com.
  2. Log in and go to My Apps, then click Create App.
  3. Fill in the required profile information, including the app name.
  4. Add up to 200 characters of search keywords.
  5. Select the app type (Public or Private) and the distribution type (Agency or Subaccount).
  6. Add the scopes needed for your app’s functionality.
  7. Generate client credentials and note the Client ID and Client Secret.
  8. Create a GET endpoint in your application to receive the OAuth redirect and capture the authorization code.
  9. Set the OAuthToken Redirect URL in the app settings to point to the GET endpoint you created.
  10. Create a POST endpoint in your application to accept JSON webhook payloads.
  11. Enter the URL of the POST endpoint in the app’s webhook settings.
  12. As an agency administrator, open the app in the Marketplace, click + Add App, and select the location or account to attach the webhook.
  13. Copy the authorization code from the redirected URL, append it to your redirect URL, and open that URL in a browser to complete the token exchange.
  14. Verify the webhook connection by confirming that a successful token response was received and that your POST endpoint receives test events.

06What it looks like in HighLevel

07Settings that matter

  • App Name. Identifies your application in the Marketplace and helps users recognize it.
  • Search Keywords. Text that improves how the app appears in Marketplace searches.
  • App Type. Determines whether the app is public (listed for anyone) or private (restricted access).
  • Distribution Type. Controls whether the app is available to all agency locations or limited to a specific subaccount.
  • OAuthToken Redirect URL. The endpoint in your app that receives the authorization code and completes the token exchange.
  • Scopes. Define the exact permissions the app needs to access HighLevel resources.

08Things to know before you rely on it

  • Private apps can be installed in up to five unique agencies; installs beyond that are blocked.
  • Hashed Company ID is deprecated and should no longer be used.
  • There is no fixed limit on the number of scopes you can add, but include only those required.
  • PKCE support is optional and recommended for public clients.

09How it connects to the rest of HighLevel

Michael's take

Michael Reimer
Michael ReimerFounder of CRM Pros, HighLevel Commander and Certified Admin

The OAuth API gives developers a reliable way to access HighLevel data without handling user passwords.

Make sure the OAuthToken Redirect URL matches exactly what you configure, otherwise the token exchange will fail.

Get More InformationOpens on HighLevelPublished November 2, 2026 · Updated November 16, 2026

Common questions

Common questions about the OAuth API for the CRM Marketplace.

What is the Developer Marketplace?

It is a HighLevel platform where developers can build, list, and distribute custom applications that integrate with HighLevel.

How do I sign up for a developer account on the Marketplace?

Visit marketplace.gohighlevel.com and click the sign up button, then follow the prompts to create your developer profile.

What are scopes in the context of app settings?

Scopes specify the permissions your app requires, such as reading contacts or managing conversations, and are defined when you add them to the app.

How do I generate client credentials for my app?

In the app settings, use the generate client credentials option to receive a Client ID and a Client Secret for authentication.

What is the purpose of the OAuthToken Redirect URL?

It tells HighLevel where to send the authorization code after a user grants permission, allowing your app to exchange it for an access token.

How can I create a webhook endpoint for my application?

Set up a POST endpoint in your server that can receive and process JSON payloads sent by HighLevel when the configured events occur.

Next step

Pick the features that matter. Then get the plan that unlocks them.

Explore the features you want, start with the five at the top, and upgrade through my link when you are ready. The bonuses and the team come with it.

The features directory explains every HighLevel feature in plain English. Browse it to see what the platform can do.

Back to the FeaturesSee the full details
⌃

Site preview

Explore the next page

This destination is reserved in the page inventory and is not built yet.