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 Settings → Integrations → API 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 Job → Print 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 Job → Print 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 Template → Create
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 Job → Create
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

• Labelify - Main application
• API Documentation - API endpoint
• n8n Community Nodes

License

MIT