TailURL n8n### 🔗 TailURL Node (Operations)

• URL Shortening: Create shortened URLs with custom slugs and titles
• List URLs: Get all URLs for a team with pagination support
• QR Code Generation: Generate QR codes with customizable sizes
• Analytics: Retrieve comprehensive analytics data
• Webhook Management: Create, list, and delete webhooks
• Team Support: Full team-based organization supportty Nodes

Complete n8n integration for TailURL API - URL shortening, QR codes, webhooks, and analytics automation

🎯 Overview

This package provides comprehensive n8n nodes for integrating with TailURL's powerful API. Built specifically for the TailURL n8n.io Integration Guide, it enables real-time event-driven automation for URL management, analytics tracking, and QR code operations.

🚀 Features

� TailURL Node (Operations)

• URL Shortening: Create shortened URLs with custom slugs and titles
• Bulk Operations: Create and update multiple URLs efficiently
• QR Code Generation: Generate QR codes with customizable sizes
• Analytics: Retrieve comprehensive analytics data
• Webhook Management: Create, list, and delete webhooks
• URL Templates: Create and use templates for bulk URL generation
• Team Support: Full team-based organization support

� TailURL Trigger Node (Webhooks)

• Real-time Events: Listen for URL clicks, creation, updates, and deletions
• QR Code Events: Track QR code generation and scanning
• Analytics Alerts: Respond to analytics thresholds
• Team Events: Monitor team member changes
• Security: HMAC signature verification for webhook authenticity
• Filtering: Advanced URL and event filtering options
• API Key Authentication: Secure credential management
• Error Handling: Comprehensive error handling with detailed messages
• Retry Logic: Automatic retry for failed operations
• Input Validation: Robust validation for all parameters

Installation

NPM Installation

npm install n8n-nodes-tailurl

Manual Installation

1. Download the latest release
2. Extract to your N8N custom nodes directory
3. Restart your N8N instance

Quick Start

1. Configure Credentials

1. In N8N, go to Settings > Credentials
2. Create new TailURL API credential
3. Enter your API key and base URL
4. Test the connection

2. Use the TailURL Node

1. Add TailURL node to your workflow
2. Select desired operation
3. Configure parameters
4. Execute the workflow

3. Set Up Webhooks (Optional)

1. Add TailURL Trigger node
2. Configure events to monitor
3. Set up webhook URL in TailURL dashboard
4. Create automation workflows

Operations

URL Shortening

{
  "operation": "shortenUrl",
  "originalUrl": "https://example.com/very/long/url",
  "folderId": "folder_123",
  "options": {
    "customSlug": "my-link",
    "title": "My Important Link",
    "generateQr": true
  }
}

QR Code Generation

{
  "operation": "generateQr",
  "qrUrl": "https://short.ly/abc123",
  "qrOptions": {
    "size": 400,
    "format": "png",
    "errorCorrection": "M"
  }
}

List URLs

{
  "operation": "listUrls",
  "teamId": "team_123",
  "limit": 50,
  "offset": 0
}

Analytics Retrieval

{
  "operation": "getAnalytics",
  "analyticsUrl": "url_123",
  "analyticsOptions": {
    "dateRange": {
      "startDate": "2025-01-01",
      "endDate": "2025-01-31"
    },
    "groupBy": ["date", "country"],
    "includeDetails": true
  }
}

Webhook Events

The TailURL Trigger node supports the following events:

• url.created - New URL created
• url.updated - URL updated
• url.deleted - URL deleted
• url.clicked - URL clicked by user
• qr.generated - QR code generated
• qr.scanned - QR code scanned
• analytics.threshold - Analytics threshold reached
• team.member.added - Team member added
• team.member.removed - Team member removed

Example Workflows

Social Media Automation

Trigger: TailURL Trigger (url.created)
↓
Process: Format social media post
↓
Action: Post to Twitter, LinkedIn, Facebook

Marketing Campaign Tracking

Trigger: TailURL Trigger (url.clicked)
↓
Process: Update lead score in CRM
↓
Condition: If high-value lead
↓
Action: Notify sales team

Content Distribution

Trigger: Schedule (Daily)
↓
Process: Fetch new blog posts
↓
Action: Create short URLs with TailURL
↓
Action: Generate QR codes
↓
Action: Update content calendar

Advanced Configuration

Resource Locators

The node uses dynamic resource locators for:

• Folders: Browse and select folders with autocomplete
• URLs: Search and select existing URLs
• Teams: Choose from available teams

Error Handling

// Automatic retry on network errors
// Detailed error messages with context
// Graceful fallback for partial failures

Rate Limiting

// Built-in rate limiting respect API limits
// Request batching for bulk operations
// Connection pooling for optimal performance

API Reference

Authentication

All requests require a valid TailURL API key:

Authorization: Bearer your-api-key-here

Base URL

Configure your TailURL instance base URL:

https://your-domain.tailurl.com

Request Format

{
  "originalUrl": "https://example.com",
  "folderId": "folder_123",
  "customSlug": "my-link"
}

Response Format

{
  "success": true,
  "data": {
    "id": "url_123",
    "slug": "my-link",
    "destination": "https://example.com",
    "shortUrl": "https://short.ly/my-link",
    "qrCode": {
      "id": "qr_456",
      "downloadUrl": "https://short.ly/qr/qr_456.png"
    }
  }
}

Troubleshooting

Common Issues

Authentication Errors

• Verify API key is correct and active
• Check base URL format (include https://)
• Ensure API key has required permissions

Webhook Issues

• Verify webhook URL is accessible from internet
• Check webhook signature if using secret
• Review N8N logs for detailed error messages

Rate Limiting

• Monitor API usage in TailURL dashboard
• Use bulk operations for multiple items
• Implement delays between requests if needed

Debug Mode

Enable debug logging by setting:

export N8N_LOG_LEVEL=debug

Support

Documentation

• TailURL API Documentation
• N8N Node Development Guide

Community

• N8N Community Forum
• TailURL Discord
• GitHub Issues

Commercial Support

For enterprise support and custom development:

• Email: [email protected]
• Website: https://tailurl.com/enterprise

Contributing

We welcome contributions! Please see our Contributing Guide for details.

Development Setup

# Clone repository
git clone https://github.com/tailurl/n8n-nodes-tailurl.git
cd n8n-nodes-tailurl

# Install dependencies
npm install

# Build for development
npm run dev

# Run tests
npm test

# Build for production
npm run build

Code Style

• TypeScript with strict mode
• ESLint with N8N node rules
• Prettier for formatting
• Jest for testing

License

MIT License - see LICENSE file for details.

Changelog

v1.0.0

• Initial release
• URL shortening operations
• QR code generation
• Analytics retrieval
• Webhook trigger node
• Comprehensive error handling

Made with ❤️ for the N8N community