# Webhook: New SaaS Plan Created > Receive real-time notifications when a new SaaS plan is created. Get features, pricing, and add-ons in one payload to sync billing and analytics. - Source: https://docs.ghlcustomercare.com/docs/saas-configurator/saas-mode/webhook-new-saas-plan-created - Section: SaaS Configurator / Saas Mode - Reading time: 3 min - Images: 1, each explained below --- Receive real-time notifications whenever a new SaaS plan is created in your GHL Customer Care account. This webhook automatically delivers all the plan’s configuration details—features, pricing tiers, and add-ons—allowing you to streamline billing, analytics, and custom integrations without polling the API. --- **TABLE OF CONTENTS** - [What is the New SaaS Plan Created Webhook?](#what-is-the-new-saas-plan-created-webhook) - [Key Benefits of Webhook: New SaaS Plan Created](#key-benefits-of-webhook-new-saas-plan-created) - [Payload Example](#payload-example) - [Security Requirements](#security-requirements) - [Error Handling & Versioning](#error-handling-and-versioning) - [Developer Resources](#developer-resources) - [Use Cases](#use-cases) - [Frequently Asked Questions](#frequently-asked-questions) --- ## **What is the New SaaS Plan Created Webhook?** New SaaS Plan Created is an automated event trigger that fires as soon as a new SaaS plan is added to your GHL Customer Care account. It returns a payload identical to the GET /plans endpoint, delivering detailed information including plan configuration, metadata, bundled features from the saasProducts array, pricing options from the prices array, and any optional add-ons from the addOns array. This feature is ideal for ensuring your billing systems, analytics tools, and third-party integrations remain up to date. For further technical details, please refer to the Developer Resources. Whenever a new SaaS plan is added via the platform, this webhook triggers automatically. It returns the same structure as the GET /plans endpoint, giving you full visibility into: - Plan configuration and metadata - Included features via the saasProducts array - Pricing details (e.g., monthly, yearly options) via the prices array - Optional add-ons are included in the add-ons array **ENDPOINT**: [https://services.leadconnectorhq.com/saas/agency-plans/:companyId](https://services.leadconnectorhq.com/saas/agency-plans/:companyId) ![What is the New SaaS Plan Created Webhook? (image 1 of 1)](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/155058217153/original/Ugxg5AGQ3fx4uhV4-UnoQW-58OgHXg3M_A.png) **What is the New SaaS Plan Created Webhook? (image 1 of 1)** This screenshot appears in the "What is the New SaaS Plan Created Webhook?" section of "Webhook: New SaaS Plan Created". The text alongside this image reads: ENDPOINT: https://services.leadconnectorhq.com/saas/agency-plans/:companyId. This part of the guide covers 3 fields, listed below. Immediately after, the guide continues: This webhook simplifies your operations by delivering plan details automatically as soon as they’re created. - What this covers: ENDPOINT: https://services.leadconnectorhq.com/saas/agency-plans/:companyId - Fields: Plan configuration and metadata, Included features via the saasProducts array, Optional add-ons are included in the add-ons array - Controls: ENDPOINT - Next: This webhook simplifies your operations by delivering plan details automatically as soon as they’re created. Full procedure: 1. Plan configuration and metadata 2. Included features via the saasProducts array 3. Pricing details (e.g., monthly, yearly options) via the prices array 4. Optional add-ons are included in the add-ons array --- ## **Key Benefits of Webhook: New SaaS Plan Created** This webhook simplifies your operations by delivering plan details automatically as soon as they’re created. - **Automated Billing Sync:** Keeps your billing platform current with new plan offerings. - **Real-Time Analytics:** Enables immediate tracking of plan creation trends without manual data pulls. - **Seamless Integrations:** Powers custom workflows and third-party tools with up-to-the-second plan configurations. - **Reduced API Load:** Eliminates frequent polling of the GET /plans endpoint, improving performance. --- ## **Payload Example** Understanding the webhook structure helps you parse and process incoming data without guesswork. ``` POST /webhook/saas/agency-plans/:companyId { "id": "plan_12345", "name": "Professional Suite", "saasProducts": [ { "id": "prod_abc", "name": "CRM", "enabled": true }, { "id": "prod_def", "name": "Marketing Automation", "enabled": true } ], "prices": [ { "interval": "monthly", "amount": 49.99 }, { "interval": "yearly", "amount": 499.99 } ], "addOns": [ { "id": "addon_001", "name": "Extra Users", "price": 10 } ], "metadata": { "createdBy": "user_789", "createdAt": "2025-08-07T12:34:56Z" } } ``` Above: A sample payload showing plan identifiers, feature toggles, pricing tiers, and optional add-ons. --- ## **Security Requirements** Protect your endpoint by validating each webhook request. GHL Customer Care signs webhook payloads with an HMAC SHA256 signature included in the X-GHL Customer Care-Signature header. By verifying this signature against your secret key, you can confirm the authenticity of each notification and safeguard against tampering. Link:[_Webhook Security Best Practices_](https://docs.ghlcustomercare.com/docs/opportunities-and-pipelines/managing-opportunities/opportunities-faqs) --- ## **Error Handling & Versioning** Ensure robust processing by accounting for failures and future changes. - **Error Codes:** Respond with HTTP 2xx for success. For non-2xx responses, GHL Customer Care retries up to three times with exponential backoff. - **Rate Limits:** Webhook events are rate-limited to 100 requests per minute per company. - **Versioning:** The payload follows version v1. Future versions will increment the endpoint path (e.g., /v2/agency-plans). Always check the schemaVersion field to adapt to new formats. --- ## **Developer Resources** Find complementary guides and API references to expand your integration capabilities. - [Public API Endpoints for SaaS Configurator](https://docs.ghlcustomercare.com/docs/saas-configurator/saas-mode/public-api-endpoints-for-saas-configurator) - Guide to SaaS Plan Creation, Sales, and Customer Onboarding - [Workflow Action – Webhook](https://docs.ghlcustomercare.com/docs/workflows/webhooks-workflow-actions/workflow-action-webhook-outbound) - [Custom Webhook – LC Premium Action](https://docs.ghlcustomercare.com/docs/workflows/workflow-builder/guide-to-custom-webhook-workflow-action) --- ## **Use Cases** - Billing integrations that need to reflect the latest available plans - Custom analytics pipelines that track SaaS product offerings over time - Automations or third-party syncs that require immediate updates on plan changes --- ## **Frequently Asked Questions** **Q: How do I retrieve past plan creation events?** Use the GET /plans endpoint to list historical plans; webhooks only deliver new events. **Q: What happens if my endpoint returns HTTP 500?** GHL Customer Care retries delivery up to three times with exponential backoff. Ensure your endpoint handles idempotency. **Q: Can I filter specific plan types from the webhook?** No, this webhook fires for all plan creations. Implement filtering logic in your receiver based on metadata or plan properties. **Q: Will I receive updates if a plan is modified?** No. For plan updates, subscribe to the separate **Webhook: SaaS Plan Updated** event. **Q: How should I handle schema changes?** Check the schemaVersion field in each payload and adjust parsing logic for new versions. **Q: How do I verify that the webhook is working correctly?** After setup, create a new SaaS plan to confirm that the webhook triggers and returns the expected data payload. --- Documentation for GHL Customer Care. Support: support@ghlcustomercare.com