blackbee

n8n community node for the Blackbee AI Accounts-Payable API.

Package Information

Released: 3 mo ago
Downloads: 29 weekly / 248 monthly
Latest Version: 0.2.3
Author: Blackbee AI

Available Nodes

Blackbee AI icon
Blackbee AI
Interact with the Blackbee AI Accounts-Payable API

Documentation

n8n-nodes-blackbee

n8n community node for the Blackbee AI Accounts-Payable API. Automate vendor onboarding and bill ingestion from any n8n workflow.

npm version

Prerequisites

  • An n8n instance (self-hosted >= 1.56 or n8n Cloud).
  • Node.js >= 20.15 (for self-hosted).
  • A Blackbee AI account and an API key.

Compatibility

Version
n8n >= 1.56
Node.js >= 20.15
Blackbee AI API current

Installation

n8n Cloud / self-hosted UI

Settings → Community Nodes → Install → enter n8n-nodes-blackbee → Install.

Self-hosted via npm

npm install n8n-nodes-blackbee

Then restart your n8n instance.

Credentials

This node authenticates via an API key issued from the Blackbee AI application.

Generate an API key

  1. Log in to your Blackbee AI application.
  2. Go to Settings → System → API keys.
  3. Click Generate to create a new key.
  4. Copy the key immediately — it is shown only once.

Configure the credential in n8n

Create a Blackbee AI API credential and paste the key:

Field Description
API Key Your Blackbee AI API key. Sent as Authorization: ApiKey <key> on every request.

Operations

Vendor

Operation HTTP Path Purpose
Create POST /ap-api/vendor/create Create a vendor with contact, remit-to, bank, and attachment details.
Get GET /ap-api/vendor/{vendorId} Fetch a single vendor by ID.
Get List POST /ap-api/vendor/list Fetch a paginated, filtered list of vendors.

Bill

Operation HTTP Path Purpose
Upload POST /ap-api/bill/upload Upload a bill document (PDF / JPG / JPEG / PNG) — triggers AI line-item extraction.
Get GET /ap-api/bill/{billUrn} Fetch a single bill by URN.
Get List POST /ap-api/bill/list Fetch a paginated, filtered list of bills.

Usage

Example: create a vendor

  1. Add a Blackbee AI node, set Resource = Vendor, Operation = Create.
  2. Select or create a Blackbee AI API credential.
  3. Fill the required Vendor Name.
  4. Open Additional Fields to add optional details — address, remit-to info, bank accounts, contact, attachments, taxId (exactly 9 digits, no separators), etc.
  5. Execute. The vendor ID is returned in the response body.

Example: upload a bill

  1. Fetch a file into the workflow with a node that produces binary data (e.g. Read Binary File, HTTP Request, Google Drive).
  2. Add a Blackbee AI node, set Resource = Bill, Operation = Upload.
  3. Set Binary Property to the name of the binary property holding the file (default data).
  4. Execute. The response contains the bill ID; Blackbee AI begins parsing asynchronously.

Resources

Development

npm install
npm run lint
npm run build

To test locally against an n8n dev instance, link the built dist/ via N8N_CUSTOM_EXTENSIONS:

npm link
cd /path/to/your/n8n-install
npm link n8n-nodes-blackbee
n8n start

License

MIT

Discussion