n8n

GrowPanel offers a native n8n community node that makes it easy to build powerful subscription automation workflows. The node automatically subscribes to GrowPanel webhooks and triggers your workflows when MRR events occur.

Installing the node

The GrowPanel node is available as an npm package. Install it in your n8n instance:

npm install n8n-nodes-growpanel

After installation, restart n8n and you'll find the GrowPanel Trigger node in the node palette.

For n8n Cloud users, community nodes can be installed via Settings > Community Nodes.

Setting up credentials

Before using the GrowPanel Trigger node, you need to configure your API credentials:

1. In n8n, go to Settings > Credentials
2. Click Add Credential and search for "GrowPanel"
3. Enter your GrowPanel API key (found in Settings > API Keys in GrowPanel)
4. Click Save

The node will automatically verify your API key when you save.

Using the GrowPanel Trigger

The GrowPanel Trigger node listens for subscription events and starts your workflow when they occur.

Event types

Optional filters

• Minimum MRR Change - Only trigger if the MRR change is at least this amount (in cents)
• Currency Filter - Only trigger for events in a specific currency

Example workflows

Slack notification for high-value churn

1. Add a GrowPanel Trigger node set to "Churn"
2. Set Minimum MRR Change to 10000 (= $100)
3. Connect to a Slack node to post to #revenue-alerts

CRM update on new subscription

1. Add a GrowPanel Trigger node set to "New Subscription"
2. Connect to a HTTP Request node that updates your CRM
3. Use the customer email and MRR data from the trigger payload

Failed payment recovery

1. Add a GrowPanel Trigger node set to "Failed Payment"
2. Connect to your dunning email service or internal ticketing system
3. Use the payment details to create appropriate follow-up

Trigger payload

The GrowPanel Trigger provides the following data to your workflow:

{
  "event": "new",
  "timestamp": "2025-03-15T10:30:00Z",
  "customer": {
    "id": "cus_456",
    "name": "Acme Corp",
    "email": "[email protected]",
    "status": "active",
    "current_mrr": 4900,
    "currency": "usd"
  },
  "movement": {
    "type": "new",
    "mrr_change": 4900,
    "currency": "usd",
    "date": "2025-03-15",
    "plan_name": "Pro Plan",
    "subscription_id": "sub_789"
  }
}

For failed payment events, the payload includes payment details instead of movement:

{
  "event": "failed_payment",
  "timestamp": "2025-03-15T14:30:00Z",
  "customer": {
    "id": "cus_456",
    "name": "Acme Corp",
    "email": "[email protected]",
    "status": "past_due",
    "current_mrr": 4900,
    "currency": "usd"
  },
  "payment": {
    "invoice_id": "inv_789",
    "amount": 4900,
    "currency": "usd",
    "failure_reason": "card_declined",
    "attempt_count": 1,
    "date": "2025-03-15"
  }
}

How it works

When you activate a workflow with a GrowPanel Trigger node:

1. n8n calls the GrowPanel API to register a webhook subscription
2. GrowPanel stores the webhook URL with your event filter settings
3. When a matching event occurs, GrowPanel sends a POST request to n8n
4. n8n receives the payload and executes your workflow

When you deactivate the workflow, n8n automatically removes the webhook subscription from GrowPanel.

Troubleshooting

Credential test fails

• Verify your API key is correct (copy from Settings > API Keys in GrowPanel)
• Ensure your GrowPanel subscription includes API access

Triggers not firing

• Check that your workflow is active (not just saved)
• Verify the event type matches what you're expecting
• Check if filters (minimum MRR, currency) are too restrictive

Multiple triggers for same event

• This is expected if you have multiple workflows listening for the same event type
• Each workflow with a GrowPanel Trigger creates its own webhook subscription

Related pages

• Webhooks - Custom webhook integration
• Make - Make (Integromat) integration
• Integrations overview - How integrations work