fynlink

n8n community node for Fynlink - The privacy-first URL shortener

Package Information

Downloads: 0 weekly / 0 monthly
Latest Version: 0.1.1
Author: eightam

Available Nodes

Fynlink icon
Fynlink
Interact with Fynlink API - The privacy-first URL shortener

Documentation

n8n-nodes-fynlink

This is an n8n community node that lets you use Fynlink in your n8n workflows.

Fynlink is a privacy-first URL shortener with end-to-end encryption, custom domains, deep analytics, and advanced features like geo-targeting and device-specific redirects.

n8n is a fair-code licensed workflow automation platform.

Installation
Operations
Credentials
Compatibility
Usage
Resources

Installation

Follow the installation guide in the n8n community nodes documentation.

Community Node Installation

  1. Go to Settings > Community Nodes in your n8n instance
  2. Select Install
  3. Enter n8n-nodes-fynlink in the Enter npm package name field
  4. Click Install

Operations

Link

  • Create: Create a new short link with optional advanced features

    • Custom slugs
    • Titles, tags, and notes
    • Password protection
    • Link expiration (TTL)
    • Device-specific redirects (iOS/Android)
    • Geo-targeting by country
    • Analytics tracking levels
    • Private links
    • Safe mode

  • Get: Retrieve details of a specific link by ID

    • Returns all link metadata
    • Includes click statistics
    • Decrypted data (requires secret key)

  • List: List all links with pagination and filtering

    • Pagination support
    • Sort by: created date, updated date, or clicks
    • Filter by: private links, safe mode, password-protected
    • Return all or limit results

  • Delete: Delete a link by ID

Credentials

To use this node, you need:

  1. API Token: Your Fynlink API token (format: token_<base64-encoded-string>)
  2. Secret Key: Your Fynlink secret key for decryption operations
  3. Base URL (optional): Defaults to https://api.fyn.link/v1

How to Get Your Credentials

Note: The Fynlink SDK is currently in beta. Here's how to obtain your credentials:

  1. Sign up for a Fynlink account if you don't have one
  2. Log in to your Fynlink dashboard (usually at app.fyn.link)
  3. Navigate to Team Settings:
    • Look for Settings → API or Developer section
    • Or check under your team/workspace settings
  4. Generate API credentials:
    • Create a new API token (it should already include the token_ prefix)
    • Copy the secret key (required for viewing/listing links)
  5. Copy both values to your n8n credentials

Token Format:

  • ✅ Correct: token_abc123def456... (includes prefix)
  • ❌ Incorrect: abc123def456... (missing prefix)

If you can't find the API settings, contact Fynlink support or check their documentation for the latest instructions.

Compatibility

  • Minimum n8n version: 0.198.0
  • Tested on: n8n 1.0+

Usage

Basic Example: Create a Short Link

Input: Any trigger
Fynlink Node:
  - Operation: Create
  - Target URL: https://example.com
  - Domain: fyn.li
Output: Short link data including short_url

Advanced Example: Create a Link with Geo-Targeting

Input: Any trigger
Fynlink Node:
  - Operation: Create
  - Target URL: https://example.com
  - Domain: fyn.li
  - Additional Fields:
    - Title: My Product Launch
    - Tags: marketing, product
    - iOS Link: https://apps.apple.com/app/myapp
    - Android Link: https://play.google.com/store/apps/myapp
    - Geo Targets: {"US": "https://us.example.com", "UK": "https://uk.example.com"}
    - Analytics: Full Analytics
    - Private Link: true
Output: Short link with device and geo-targeting

Example: List All Private Links

Input: Any trigger
Fynlink Node:
  - Operation: List
  - Return All: true
  - Additional Fields:
    - Filter Private Links: true
    - Sort By: Created At
    - Sort Order: Descending
Output: Array of all private links

Features

Privacy & Security

  • End-to-end encryption for link data
  • Password-protected links
  • Private links (not listed publicly)
  • Safe mode for content screening

Advanced Redirects

  • iOS-specific URLs
  • Android-specific URLs
  • Country-based geo-targeting
  • Default fallback URL

Analytics

  • Click tracking (configurable)
  • Three levels: No Analytics, Partial, Full
  • Performance metrics
  • Click statistics per link

Management

  • Custom slugs for branded links
  • Link expiration (TTL)
  • Tags for organization
  • Notes for documentation
  • Bulk operations via List

Resources

Version History

0.1.0

  • Initial release
  • Support for Create, Get, List, and Delete operations
  • Full support for advanced features:
    • Custom slugs
    • Device-specific redirects
    • Geo-targeting
    • Password protection
    • Analytics levels
    • Link expiration
    • Tags and metadata

License

MIT

Discussion