GoHighLevel Setup

Kotally can connect to GoHighLevel for each managed sub-account. If you run API-only, skip this page and use the API Quickstart instead.

Marketplace install

1. From Kotally setup or Locations → Add location, choose Connect GoHighLevel (or install from the Marketplace / /oauth/ghl/install).
2. Approve the OAuth prompt and pick the sub-account.
3. Kotally stores the installation tokens for that location.
4. Complete Kotally billing and product mapping before using the location live.

The production OAuth redirect path is /oauth/ghl/callback on your Kotally app domain.

Webhooks

Configure GoHighLevel to send events to:

POST /webhooks/ghl

Appointment events must include locationId, contactId, calendarId, and serviceId when available. Payment events need product information Kotally can match to an active product mapping.

Embedded dashboard

The GoHighLevel embedded views are:

• /embed/auth validates the signed GoHighLevel context and starts the embed session.
• /embed/dashboard shows a read-only customer and location view.
• /embed/panel shows the compact side-panel experience when enabled.

If the side panel is unavailable on a GoHighLevel surface, use the Open Kotally fallback from the embed.

Sandbox testing

For sandbox custom menu or link testing, use the sandbox launcher if your Kotally environment exposes it:

/embed/sandbox-launch?location_id=<ghl-location-id>&user_id=<ghl-user-id>&agency_id=<ghl-agency-id>&token=<sandbox-token>

The token must match the configured sandbox launch token for that environment.