labelify

n8n community node for Labelify label printing system

Package Information

Downloads: 41 weekly / 92 monthly
Latest Version: 1.2.2

Documentation

n8n-nodes-labelify

This is an n8n community node for Labelify - a label printing system for thermal printers.

n8n is a fair-code licensed workflow automation platform.

Installation

Via n8n GUI (Recommended)

  1. Open your n8n instance
  2. Go to Settings (gear icon in the bottom left)
  3. Click Community Nodes
  4. Click Install a community node
  5. Enter: n8n-nodes-labelify
  6. Click Install
  7. The Labelify node will appear in your node palette

Via npm (Self-hosted)

npm install n8n-nodes-labelify

Then restart your n8n instance.

Operations

Print Job

Operation Description Required Scope
Create Create a print job from a template with variables print:write
Print Product Print by product ID or SKU (simplified POS) print:write
Print Order Print multiple products from an order (batch) print:write
Get Get print job status print:read
Get Many List print jobs print:read
Cancel Cancel a pending print job print:write

Product

Operation Description Required Scope
Create Create a product products:write
Get Get a product products:read
Get Many List products products:read
Update Update a product products:write
Delete Delete a product products:write

Template

Operation Description Required Scope
Create Create a new template with ZPL code templates:write
Get Get a template templates:read
Get Many List templates templates:read
Delete Delete a template (if no products use it) templates:write

Category

Operation Description Required Scope
Create Create a category categories:write
Get Many List categories categories:read
Delete Delete a category (if no products assigned) categories:write

Printer

Operation Description Required Scope
Get Many List configured printers printers:read

Credentials Setup

  1. Log in to your Labelify account at labelify.app
  2. Go to SettingsIntegrationsAPI Keys
  3. Click Create API Key
  4. Select the scopes you need (or use a preset like "Full Access")
  5. Copy the API key (format: lbl_live_xxx_xxx_sk_xxx)
  6. In n8n, create new Labelify API credentials and paste your key

Usage Examples

POS Integration - Print Product by SKU

The easiest way to integrate with point-of-sale systems:

  1. Add a Labelify node to your workflow
  2. Select Print JobPrint Product
  3. Choose External ID (SKU) as lookup type
  4. Map your product SKU to the External ID / SKU field
  5. Set the quantity

The node will automatically use the template and printer configured for that product.

Print Order (Batch)

Print labels for multiple products in an order:

  1. Add a Labelify node
  2. Select Print JobPrint Order
  3. Enter your Order ID
  4. Add items with their SKUs and quantities

Products that aren't configured in Labelify will be gracefully skipped.

Create a Template

Create a new label template with ZPL code:

  1. Add a Labelify node
  2. Select TemplateCreate
  3. Enter a template name
  4. Paste your ZPL code (must start with ^XA and end with ^XZ)
  5. Optionally select a default printer

Custom Print Job with Template

For full control over label content:

  1. Add a Labelify node
  2. Select Print JobCreate
  3. Choose a template
  4. Fill in template variables
  5. Set quantity and printer

Error Handling

The node provides clear error messages for common issues:

Error Cause Solution
Invalid API key Key expired, revoked, or incorrect Check credentials in Labelify settings
Insufficient permissions Missing required scope Update API key scopes in Labelify
Template in use Cannot delete template with products Reassign products to another template first
Category in use Cannot delete category with products Reassign products to another category first
Rate limit exceeded Too many requests Wait and retry, or upgrade your plan

API Scopes Reference

Scope Description
templates:read List and view templates
templates:write Create and delete templates
products:read List and view products
products:write Create, update, and delete products
print:read List and view print jobs
print:write Create and cancel print jobs
printers:read List configured printers
categories:read List categories
categories:write Create and delete categories

Resources

License

MIT

Discussion