Integrations · Developers

MRR events, delivered to your endpoint

Get a POST request for every MRR movement, scheduled cancellation and failed payment, with the customer and the movements in one JSON payload. Update your database, trigger a workflow, or feed any system that accepts webhooks.

Get started free View live demo

Free until $200k ARR
No credit card needed
Live in minutes
EU hosted, GDPR compliant

Read the setup guide

Illustration

GrowPanelSettings › Integrations › Webhooks

Endpoint URL

TestTest passed · 200 OK

ThresholdOver $100

Event types

NewExpansionContractionChurnReactivationScheduled cancellationFailed payment

Enable Webhook enabled

POST https://your-app.com/hooks/growpanel

failed_paymentBrightloop200just now

mrr_movementchurn · Stackmint200just now

scheduled_cancellationQuantia200just now

mrr_movementexpansion · Acme Cloud200just now

{
  "event": "mrr_movement",
  "customer": { "id": "cus_456", "name": "Acme Cloud", "status": "active" },
  "movements": [{
    "type": "expansion",
    "mrr_change": 15100,
    "currency": "usd",
    "plan_name": "Scale",
    "description": "upgraded to Scale",
    "is_future": false
  }]
}

Setup

Enabled in a minute

Enable webhooks
In GrowPanel, go to Settings, then Integrations, and click Enable on the Webhooks card.
Add your URL
Any HTTPS endpoint. Click Test to send a sample payload and check that you return a 2xx.
Filter events
Optional: a minimum MRR change and the event types to send. By default, every movement is sent.

Step-by-step setup guide with screenshots

How the sync works

Classified first, then delivered

Webhooks carry GrowPanel's view of what happened, so your code gets a clean expansion or churn, not a raw invoice you have to interpret.

A billing changeFrom Stripe, Chargebee, Recurly, Alunta or the API

GrowPanel classifies itAn MRR movement, a scheduled cancellation or a failed payment

Your filtersMinimum MRR change and event typese.g. over $100

POST to your endpointJSON with the customer and every movementapplication/json

Test before you save: the Test button sends a payload with dummy data (cus_test_123, Pro Plan) so you can tell it apart from real events.

Three event typesmrr_movement, scheduled_cancellation and failed_payment.

Everything in one requestThe customer and all of their movements in a single payload.

Amounts in centsWith a three-letter currency code on every movement.

Future movements flaggedis_future marks scheduled changes that haven't happened yet.

Payload

What's in every request

eventmrr_movement, scheduled_cancellation or failed_payment

customerid, name, email and status, with the ID from your billing system

movements[]type, mrr_change, currency, date, plan_name, subscription ID and a readable description

paymentinvoice ID, amount, currency, failure reason and attempt count, on failed payments

FAQ

Webhooks and GrowPanel, answered

Something else on your mind? Talk to a human, we reply within one business day.

Which events can I receive?

MRR movements (new, expansion, contraction, churn and reactivation), scheduled cancellations, and failed payments. A failed payment is only sent for the first failure after successful payments, not on every retry.

Can I filter what gets sent?

Yes. Set a minimum MRR change and choose the event types on the Webhooks card.

How do I test my endpoint?

Click Test before saving. GrowPanel sends a sample payload with dummy data, and the test passes when your endpoint returns a 2xx status.

Can I use webhooks with Zapier, Make or n8n?

Yes. Paste a Zapier Catch Hook or a Make custom webhook URL, or use the native n8n node.

What does it cost?

Webhooks are included on every plan, and GrowPanel is free until you're above $200k ARR.