Home/HighLevel/Features/SaaS Configurator/HighLevel webhook for newly created SaaS plans

Agency, Settings and Integrations

HighLevel webhook for newly created SaaS plans

In short

The New SaaS Plan Created webhook fires right away when a plan is added in HighLevel. It sends a payload that mirrors the GET /plans response, including configuration, pricing tiers and add ons, so external systems can stay synchronized without polling.

AreaSaaS Configurator · SaaS Mode
Used forBilling platform provider, Data analytics firm, Custom workflow builder
Guide typeOverview
Last updatedNovember 17, 2026

01Who this is for

  • Founders of SaaS businesses who need immediate updates to keep their billing engines aligned with new offerings.
  • Product managers responsible for tracking plan adoption trends in real time.
  • Developers building custom integrations that must react to each plan launch.

02New SaaS plan created webhooks, explained

When a new SaaS plan is added inside HighLevel, the webhook triggers automatically. It posts a JSON payload to the URL you define, containing the plan’s identifier, name, feature list, price options and any optional add ons. The payload format matches the data returned by the GET /plans endpoint, so parsing logic can be reused.

The endpoint for the webhook follows the pattern https://services.leadconnectorhq.com/saas/agency plans/:companyId. Each request includes an HMAC SHA256 signature in the X HighLevel Signature header, which you validate using the secret key you generated. This ensures that only authentic notifications are processed.

03How businesses use New SaaS plan created webhook

  • Billing platform provider. Configure the webhook URL in HighLevel. When a plan appears, the payload arrives with pricing tiers, allowing the billing system to create matching subscription options automatically.
  • Data analytics firm. Set the webhook to deliver plan data to your analytics pipeline. The incoming JSON contains metadata and feature flags, enabling immediate tracking of plan launch frequency.
  • Custom workflow builder. Create a custom workflow that receives the webhook, extracts the add ons array, and forwards the information to a third party CRM for record keeping.

04The numbers and rules that matter

  • Rate limit: 100 requests per minute per company.
  • Retries: Up to three times with exponential backoff for non 2xx responses.
  • Payload version: V1 (future versions change endpoint path, e.g., /v2/agency plans).
  • Signature header: X HighLevel Signature using HMAC SHA256.

05What it looks like in HighLevel

06Settings that matter

  • X HighLevel Signature header. Contains an HMAC SHA256 hash of the payload that you verify with your secret key to confirm the request’s authenticity.
  • schemaVersion field. Indicates the version of the payload structure so your parser can adapt when HighLevel releases a new format.

07Things to know before you rely on it

  • The webhook can be sent up to 100 requests per minute for each company.
  • If a delivery fails, HighLevel will retry up to three attempts with exponential backoff.
  • Future payload versions will appear under a new path such as /v2/agency plans; watch the schemaVersion field for changes.

08If something goes wrong

  • Endpoint returns HTTP 500. HighLevel will automatically retry three times with exponential backoff. Ensure your handler is idempotent to avoid duplicate processing.
  • No data arrives after creating a plan. Create a test plan and confirm the webhook URL is reachable and that the X HighLevel Signature is being validated correctly.

09How it connects to the rest of HighLevel

Michael's take

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

Most people assume the webhook will automatically keep their billing system in sync without any further work. In reality, you need a listener that validates the signature, parses the payload and updates your catalog, otherwise you’ll miss the new plan data.

I would set up a simple endpoint that logs the incoming payload, checks the X HighLevel Signature and then calls the billing API to add the plan. Running a test creation right after the setup confirms everything is wired correctly before you rely on it for production data.

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

Common questions

Common questions about New SaaS plan created webhook.

How can I get information about plans created before I set up the webhook?

Use the GET /plans endpoint to retrieve the full list of existing plans. The webhook only sends events for plans created after it is configured.

What does HighLevel do if my endpoint fails with an error code?

For any non 2xx response, HighLevel retries delivery up to three times, applying exponential backoff between attempts.

Can I limit the webhook to only certain types of plans?

The webhook fires for every new plan. You must implement any filtering logic in your receiving application based on the payload’s properties.

Will I be notified when an existing plan is edited?

No. This webhook is only for plan creation events. To receive updates for changes, subscribe to the separate "SaaS Plan Updated" webhook.

How do I know if the payload format has changed?

Each payload includes a schemaVersion field. Check its value and adjust your parsing code when a new version is released.

What is the best way to verify the webhook is working after setup?

Create a new SaaS plan in HighLevel and watch for the incoming POST request. Confirm the payload matches the example and that the signature validates.

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.