GoHighLevel Setup

Kotally relies on a GoHighLevel Marketplace install for each managed sub-account.

Marketplace install

1. Install the Kotally app in the target GoHighLevel sub-account.
2. Approve the OAuth prompt.
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.