Package Information
Documentation
n8n-nodes-listbee
Sell anything from n8n. This community node integrates ListBee into your n8n workflows — create listings, manage orders, handle fulfillment, and react to events via webhooks.
Install
In your n8n instance: Settings → Community Nodes → Install → enter n8n-nodes-listbee.
Credentials
Get your API key at listbee.so → Console → API Keys. The key starts with lb_.
In n8n, go to Credentials → Add Credential → ListBee API, paste your key, and save. n8n verifies it automatically against the API.
Nodes
ListBee (regular node)
API operations across all ListBee resources. Can also be used as an AI tool node.
ListBee Trigger
Starts workflows when ListBee events occur. Automatically registers and cleans up webhooks when the workflow is activated or deactivated. Incoming events are verified using HMAC-SHA256 signatures.
Operations
25 operations across 9 resources.
Account
| Operation | Description |
|---|---|
| Get | Get account status, plan, fee rate, and operational readiness |
| Update | Update account settings (GA Measurement ID, order notifications, events callback URL) |
| Delete | Permanently delete the account and all associated data |
API Keys
| Operation | Description |
|---|---|
| Self Revoke | Permanently revoke the API key used to authenticate this request |
Bootstrap
Public endpoints — no API key required. Use these to automate account creation and onboarding flows.
| Operation | Description |
|---|---|
| Start | Begin account bootstrap — sends a verification OTP to the email address |
| Verify | Verify the OTP code (bootstrap_token + otp_code) — returns api_key, account_id, and stripe_onboarding_url |
| Poll | Check bootstrap status by account ID — returns readiness and Stripe onboarding state |
Events
| Operation | Description |
|---|---|
| List | List all events, optionally filtered by type, listing ID, or order ID |
Listing
| Operation | Description |
|---|---|
| Create | Create a listing with product page and payment link |
| Get | Get a listing by ID |
| Get Many | List all listings, optionally filtered by status (draft/published/archived) |
| Update | Update listing fields (name, price, description, cover, and more) |
| Delete | Delete a listing permanently |
| Publish | Make a draft listing publicly visible |
| Unpublish | Revert a published listing back to draft state |
| Archive | Move a published listing to archived state |
Create and Update support: name, price, description, tagline, CTA, compare-at price, image URL, currency, highlights, badges, rating, rating count, deliverable (single), agent callback URL, signing secret, reviews, FAQs, checkout schema, and metadata.
Order
| Operation | Description |
|---|---|
| Get | Get an order by ID |
| Get Many | List orders, optionally filtered by status, listing, buyer email, or date range |
| Fulfill | Mark an order as fulfilled, optionally pushing a single deliverable to the buyer |
| Redeliver | Re-send the delivery to the buyer (resends access grant or deliverable) |
| Refund | Issue a full refund for a paid order |
Plan
| Operation | Description |
|---|---|
| List | List all available plans with pricing (public endpoint, no authentication required) |
Stripe
| Operation | Description |
|---|---|
| Connect | Get a Stripe Connect onboarding URL for guided account setup |
| Disconnect | Remove Stripe configuration from your account |
Utility
| Operation | Description |
|---|---|
| Ping | Check API connectivity and verify API key validity |
Trigger Events
The ListBee Trigger node supports all 10 event types:
| Event | Description |
|---|---|
order.paid |
A purchase was completed and payment confirmed |
order.fulfilled |
An order was fulfilled (managed or external delivery confirmed) |
order.refunded |
An order was refunded |
order.disputed |
A chargeback or dispute was opened |
order.dispute_closed |
A dispute was resolved |
order.canceled |
An order was canceled |
listing.created |
A new listing was created |
listing.updated |
A listing was updated |
listing.published |
A listing was published and made public |
listing.deleted |
A listing was deleted |
Leave the events field empty to subscribe to all events.
Fulfillment Workflows
ListBee supports two fulfillment modes:
Managed — ListBee delivers digital content automatically after payment. Set deliverables on the listing (file, URL, or text) and ListBee handles the rest.
External — ListBee fires order.paid and you handle delivery in n8n. Use the Fulfill operation to push generated or processed content back to ListBee for delivery.
Typical managed fulfillment workflow:
- Listing: Create with name, price, and
deliverable(URL or text) → get a listing ID - Listing: Publish → listing goes live with a checkout URL
- ListBee delivers the deliverable to the buyer automatically after payment
Typical external fulfillment workflow:
- ListBee Trigger (
order.paid) → workflow starts, or useagent_callback_urlon the listing - Generate or retrieve content
- Order: Fulfill → push a single deliverable to ListBee for the buyer
Pagination
List operations (Get Many) use cursor-based pagination. Set Limit (1–100, default 50) to control page size. The response includes a cursor field and has_more boolean — pass the cursor value to the next request to fetch the next page.
Error Handling
The node parses ListBee's RFC 9457 error responses into readable messages:
Validation error: Price must be greater than 0 [field: price]Rate limit exceeded — retry after 60sListing not found
Error responses include a request ID for support debugging.
Idempotency
Create and action operations support an optional Idempotency Key in Additional Fields. The same key and request body combination returns a cached response instead of creating a duplicate — safe for retries.