Package Information
Documentation
@altarys/n8n-nodes-letzbill
This is an n8n community node. It lets you use LetzBill in your n8n workflows.
LetzBill is the billing service that cloud providers use to bill their customers. With these nodes, a cloud provider's staff can manage customers, subscriptions, invoices, credit notes, payments, wallets, and usage events. They can also start a workflow when something happens in LetzBill. The package contains:
- The LetzBill node, for actions on your LetzBill account. n8n's AI agents can also use it as a tool.
- The LetzBill Trigger node, which starts a workflow when LetzBill sends an event, such as a paid invoice.
- The LetzBill API credential, which both nodes use.
This package is for cloud providers' staff. If you're a customer of a cloud provider, the LetzCloud nodes are the package meant for you.
New to these nodes? Start with Getting started.
Installation
- Self-hosted n8n: follow n8n's guide to installing community nodes. In n8n, open Settings, then Community nodes. In the install dialog, enter
@altarys/n8n-nodes-letzbillin npm Package Name, confirm that you understand the risks, and select Install. - n8n Cloud: not available yet. n8n hasn't verified these packages, so install them on a self-hosted n8n instance.
Operations
The LetzBill node works on these resources:
| Resource | Operations |
|---|---|
| Credit Note | Create, Get, Get Many, Void |
| Customer | Create, Delete, Get, Get by External ID, Get Many, Update |
| Invoice | Create One-Off, Download PDF, Finalize, Get, Get Many, Send, Void |
| Payment | Create, Get, Get Many, Refund |
| Subscription | Create, Get, Get by External ID, Get Many, Terminate, Update |
| Usage Event | Create, Create Batch, Get, Get Many |
| Wallet | Create, Get, Get Many, Get Transactions, Top Up |
| Webhook Endpoint | Delete, Get, Get Many, Send Test |
Every parameter and output field is in the operations reference. The LetzBill Trigger node and its events are described in LetzBill Trigger.
Credentials
You need a LetzBill API key and the address of the LetzBill API. A LetzBill API key starts with fb_, and you create it in the console under Billing > Developers > API keys. The same page shows the API address, which must start with https://.
Step-by-step instructions, the permissions each node needs, and how to replace a key are in Credentials.
Compatibility
- Minimum n8n version: 2.47.7. Earlier versions aren't supported.
- Node.js: n8n 2.47.7 needs Node.js 24 or later.
- Tested: version 0.1.1 is built, linted, and unit-tested with the n8n node tools and
n8n-workflow2.47.2. Tests on a running n8n instance are still to be done. - Known incompatibilities: none known.
Usage
- Getting started: install the package, add the credential, and list your invoices.
- Concepts: amounts in minor units, retries, IDs, and how lists are read.
- Example workflows: workflows you can import and adapt.
- Troubleshooting: every message the nodes show, with its cause and fix.
Resources
Version history
See the changelog.