# Limits & errors

The endpoints and marketplace surfaces of the GoHighLevel integration, what it does not do, and the common errors when connecting.

## Endpoints

The integration is built from Zernio's shared API plus a few GoHighLevel-specific surfaces. These tools show for `gohighlevel` in the dashboard's All tools tab and on the hosted MCP.

Connect and settings:

- Get connect URL: `GET /v1/connect/gohighlevel`.
- Settings: read and update at `/v1/accounts/{accountId}/gohighlevel-settings`.
- Disconnect: `DELETE /v1/accounts/{accountId}`.

Conversions and ads:

- Send events to every destination: `POST /v1/events`.
- List stored events: `GET /v1/events` (filter `source=gohighlevel`).
- Create a forwarding rule: `POST /v1/events/forwarding-rules`.
- Create a campaign: `POST /v1/ads/campaigns`.
- Boost a post as an ad: `POST /v1/ads/boost`.

## Marketplace surfaces

Surfaces GoHighLevel calls with its signed request, hosted by Zernio:

- Webhook ingest: `/api/webhook/gohighlevel`, verified by `X-GHL-Signature` (Ed25519).
- Workflow actions and triggers: `/api/integrations/gohighlevel/actions/*` and `/api/integrations/gohighlevel/triggers/*`.
- Custom page dashboard: `/api/integrations/leadconnector/custom-page`, embedded in the sub-account. It reads the sub-account from GoHighLevel's signed user context, never from the URL.

## What you cannot do

- No conversation logging. GoHighLevel owns the inbox; Zernio relays conversions and runs ads, it does not sync messages onto GoHighLevel.
- No telephony or messaging channels in v1. WhatsApp, iMessage and SMS as GoHighLevel conversation providers are a later release.
- No wallet billing configuration through the API. Rebilling and metering are set in the GoHighLevel dashboard.
- Attribution is written back only when `writeBackAttribution` is on, and conversions forward to ad platforms only when `reportToAds` is on.

## Common errors

| Error | Cause | Fix |
|-------|-------|-----|
| `gohighlevel_access_denied` on the redirect | The user declined access | Start the connect again and approve access. |
| `gohighlevel_invalid_state` on the redirect | The link expired or was already used | Request a fresh `authUrl`. |
| `gohighlevel_connection_failed` on the redirect | GoHighLevel refused the code exchange, or the location could not be read | Start the connect again; check the install covers this sub-account. |
| `503` on the connect endpoint | GoHighLevel is not configured on this Zernio environment | Contact support. |

## Related

- [Connect](/platforms/gohighlevel/connect)
- [Settings](/platforms/gohighlevel/settings)
- [What syncs](/platforms/gohighlevel/sync)