GoHighLevel webhook event

PlanChange

Called whenever user changes the plan for a paid app. GoHighLevel POSTs a JSON body carrying 7 top-level fields to your subscribed URL; the full shape is below.

How to receive it

Webhook events are delivered to the URL configured on your marketplace app as an HTTP POST with a JSON body. Acknowledge quickly with a 2xx and do the real work asynchronously — a slow handler shows up as a delivery failure. Events carry no ordering guarantee, so keep handlers idempotent and key them off the IDs in the payload rather than arrival order.

Payload fields

The JSON body POSTed to your webhook URL. Nested objects are shown indented under their parent.

NameTypeDescription
typestring

Example: PLAN_CHANGE

appIdstring

Example: ve9EPM428h8vShlRW1KT

locationIdstring

Example: otg8dTQqGLh3Q6iQI55w

companyIdstring

Example: otg8dTQqGLh3Q6iQI55w

userIdstring

Example: otg8dTQqGLh3Q6iQI55w

currentPlanIdstring

Example: 66a0419a0dffa47fb5f8b22f

newPlanIdstring

Example: 66a0419a0dffa47fb5f8b22f

Skip the schema lookup

Handling PlanChange usually means calling back into the GoHighLevel API to enrich or act on what changed. Hylo gives your AI agent every endpoint schema it needs for that second half — and can execute the call against your own sub-account.

Other webhook events