← All n8n nodes
Billing & metering

Lago n8n Node

Usage-based billing, metering, and the whole invoice lifecycle in n8n.

Lago is an open-source billing and metering platform for subscription, usage-based, and hybrid pricing. This node turns raw usage events into invoices and covers plans, prepaid credit wallets, coupons, credit notes, and the billing lifecycle around them.

Published · v0.1.0n8n approval pendingMIT licensedCloud + self-hosted
Install

In n8n Cloud or self-hosted n8n, go to Settings → Community Nodes → Install and enter the package name. After approval, this node will ship with n8n and will no longer need to be added as an npm package:

@blackswampai/n8n-nodes-lago

Why it works this way

Billing automation fails in expensive, quiet ways. An event with a code that matches no active metric is accepted, stored, and then never billed — there is no error to notice. A workflow retry can double-charge a customer. This node was built around those failure modes rather than around the shape of the API.

Billable metric codes are chosen from the metrics actually defined in your Lago instance instead of typed by hand, so a typo cannot silently stop billing. Transaction IDs are derived from the n8n execution, so Lago deduplicates a retried run instead of billing it twice.

The node also distinguishes a premium licence gate from a rejected API key. Lago answers HTTP 403 for both, so the node reports a licence problem rather than sending you off to check a credential that was working fine.

Supported resources and operations

ResourceOperations
Billable MetricCreate, Get, Get Many, Update, Delete, Evaluate Expression
CouponCreate, Get, Get Many, Update, Delete, Apply to Customer, Get Many Applied, Remove from Customer
Credit NoteCreate, Estimate, Get, Get Many, Download, Void
CustomerCreate or Update, Get, Get Many, Delete
EventSend, Send Batch, Get, Get Many, Estimate Fees
InvoiceCreate One-Off, Get, Get Many, Update, Finalize, Void, Download, Retry Payment
PlanCreate, Get, Get Many, Update, Delete
Plan ChargeCreate, Get, Get Many, Update, Delete
SubscriptionCreate, Get, Get Many, Update, Terminate
WalletCreate, Get, Get Many, Update, Terminate
Wallet TransactionCreate, Get Many
Webhook EndpointCreate, Get, Get Many, Update, Delete

Lago Trigger

Starts a workflow when Lago sends a billing event. It registers a webhook endpoint on activation, reuses an existing one for the same URL rather than adding another, and removes it on deactivation. Every delivery is verified before the workflow runs — JWT by default, with the key fetched automatically, or HMAC. Lago retries a delivery up to three times, so repeats are recognised by delivery key and skipped.

Want this running in your business?

We design, host, and monitor the workflows these nodes plug into. If Lago is part of how your business runs, we can connect it to the rest of your systems.

Ask About Lago Automation