{
  "openapi": "3.1.0",
  "info": {
    "title": "HelloGrowthCRM public site API",
    "version": "1.0.0",
    "description": "Public endpoints of the HelloGrowthCRM marketing site, with MPP payment discovery metadata for the subscription checkout flow. The CRM tool API (MCP) is described separately at https://mcp.hellogrowthcrm.com/openapi.json.",
    "contact": {
      "email": "sales@hellogrowthcrm.com",
      "url": "https://hellogrowthcrm.com/contact"
    }
  },
  "servers": [
    {
      "url": "https://hellogrowthcrm.com"
    }
  ],
  "x-service-info": {
    "name": "HelloGrowthCRM",
    "categories": [
      "crm",
      "saas",
      "sales-software"
    ],
    "payment_processors": [
      "stripe",
      "razorpay"
    ],
    "checkout_mode": "hosted",
    "pricing_url": "https://hellogrowthcrm.com/pricing",
    "agent_auth": "https://hellogrowthcrm.com/auth.md"
  },
  "paths": {
    "/api/help/search": {
      "get": {
        "operationId": "searchHelpArticles",
        "summary": "Search the HelloGrowthCRM help centre",
        "parameters": [
          {
            "name": "q",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 2
            },
            "description": "Search terms"
          }
        ],
        "responses": {
          "200": {
            "description": "Matching help articles (titles, slugs, intros)"
          }
        }
      }
    },
    "/api/newsletter/subscribe": {
      "post": {
        "operationId": "subscribeNewsletter",
        "summary": "Subscribe an email to the newsletter (double opt-in)",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "email"
                ],
                "properties": {
                  "email": {
                    "type": "string",
                    "format": "email"
                  },
                  "source": {
                    "type": "string"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Confirmation email sent; subscribed only after the human confirms"
          }
        }
      }
    },
    "/pricing": {
      "get": {
        "operationId": "startSubscriptionCheckout",
        "summary": "Subscription plans and hosted checkout entry (Growth plan)",
        "description": "Returns the pricing page (HTML) where a human selects a plan and completes payment through hosted Stripe or Razorpay checkout. No agent-executable charge endpoint exists yet — a human must complete the session.",
        "responses": {
          "200": {
            "description": "Pricing page with hosted checkout entry points"
          }
        },
        "x-payment-info": {
          "intent": "session",
          "method": "stripe",
          "amount": 10,
          "currency": "USD",
          "description": "HelloGrowthCRM Growth plan — $10 per user per month via hosted Stripe checkout (Razorpay available for INR). Human completes the hosted session; agents cannot execute this charge programmatically."
        }
      }
    },
    "/get-started": {
      "get": {
        "operationId": "getStartedSignup",
        "summary": "Signup entry for the Free Forever plan",
        "description": "Returns the get-started page (HTML). The Free Forever plan requires no payment; paid upgrades happen later via hosted checkout.",
        "responses": {
          "200": {
            "description": "Signup entry page"
          }
        },
        "x-payment-info": {
          "intent": "session",
          "method": "stripe",
          "amount": 0,
          "currency": "USD",
          "description": "Free Forever plan signup — no charge. Paid upgrades use hosted Stripe/Razorpay checkout."
        }
      }
    }
  }
}