n8n-nodes-shortio

An n8n community node for Short.io, a branded short-link service. It covers
Short.io's server-side API: links, bulk link operations, QR codes, OpenGraph, link permissions,
country/region targeting, folders, domains, statistics, and a polling trigger for new links and
clicks.

This package is unofficial. It is not affiliated with, endorsed by, or supported by Short.io.
"Short.io" is used only to describe what the node connects to.

Status: Unofficial community node; see Excluded for API features that are
not covered, and Version history for releases.

Demo

Watch the full demo video (MP4)

• Demo
• Installation
• Credentials
• Operations
• Trigger
• Bulk operations
• Rate limits
• Statistics notes
• Excluded
• Compatibility
• Usage terms
• Resources
• Version history

Installation

On a self-hosted n8n instance:

1. Go to Settings → Community Nodes.
2. Select Install, enter @t0mer/n8n-nodes-shortio, and confirm.

See the n8n guide to
installing community nodes
for other options, including manual installation with npm in a queue-mode or self-hosted setup:

npm install @t0mer/n8n-nodes-shortio

Credentials

The node authenticates with a Short.io secret API key. Public keys (the kind used in
client-side JavaScript) are not supported — every operation runs server-side.

1. In the Short.io dashboard, go to Integrations & API and create a secret key. See
   Creating an API key for the walkthrough.
2. In n8n, create a Short.io API credential and paste the key into Secret API Key.

The key's team or domain permissions limit which domains the node can see and act on — a key
scoped to one domain won't list or resolve others. The credential test calls
GET /api/domains.

Operations

Domain, Link and Folder fields use a resource locator:

• Domain — From List (fetched via GET /api/domains, shown by hostname) or By ID.
• Link — By ID (accepts both the current link_… and the older lnk_… idString format)
  or By Short URL, which accepts a full short link (https://host/path) and resolves it
  through GET /links/expand.
• Folder — From List (GET /links/folders/{domainId}) or By ID.

Link

Link OpenGraph

Link Permission

Link Country Targeting

Link Region Targeting

Folder

Domain

Statistic

See Statistics notes for the shared Period, Timezone and Filters parameters.

Trigger

Short.io Trigger is a polling trigger with two events:

• New Link — emits links created since the last poll. A link created with a backdated
  Created At earlier than the last poll's mark is not emitted, since the mark only ever moves
  forward.
• New Click — emits raw clicks recorded since the last poll, up to 2,000 clicks (20 pages of
  100. per poll; a burst larger than that is capped, with older clicks from the same burst skipped
       and a warning logged, rather than delaying the whole poll further.

On first activation, the trigger stores a high-water mark and emits nothing; later polls emit
only newer items. Fetch Test Event (manual mode) returns the most recent matching item as a
sample without changing the stored state.

Bulk operations

¹ Short.io documents no maximum for Tag Many; 150 per call is the node's own conservative batch
size, matching the sibling bulk endpoints.

All bulk operations take every input item and split it into chunks of the sizes above.
Create Many additionally groups items by domain hostname and folder before chunking, since a
single POST /links/bulk call can only carry one domain and one folder — a batch that mixes
folders or domains makes more calls than the chunk size alone implies.
Create Many is not transactional: a chunk can partly succeed. A failed link comes back as an
error item mapped to its original input index with continue-on-fail turned on; without
continue-on-fail, the node throws and lists the failing item indexes, and for Create Many the
error message also reports how many links were already created before the failure. Generate QR
Codes (Many) returns one ZIP file per chunk (not per link), so its output is one binary item per
chunk of up to 150 links.

Rate limits

Short.io's documented per-endpoint limits:

Other endpoints have no documented limit. On an HTTP 429 response, the node retries automatically
up to 3 attempts in total, honouring the Retry-After header when Short.io sends one.

Statistics notes

• Period accepts today, yesterday, total, week, month, lastmonth, last7,
  last30 (default) or custom. Choosing Custom exposes Start Date and End Date.
• Timezone is an IANA name (for example Europe/Berlin), sent as tz. Short.io's older
  tzOffset parameter is deprecated and is never sent. Dates are interpreted in the selected
  Timezone.
• Filters (where the operation supports them) are an include/exclude pair over columns such
  as country, browser, browser version, social network, HTTP status, path, protocol, method,
  referrer host, and UTM source/medium/campaign.
• Column (the Top Values operations) is one of 18 values: A/B Path, Browser, Browser Version,
  City, Country, Goal Completed, Human, Method, OS, Path, Path (404), Protocol, Referrer Host,
  Social, Status, UTM Campaign, UTM Medium, UTM Source.
• Limit on the Top Values operations and Get Raw Clicks defaults to 50, with no documented
  maximum.
• Get Raw Clicks' After Date/Before Date are pagination cursors, not a report window —
  they're ignored when Period is All Time; use Period: Custom (or another preset) to
  page through results.
• Charts (Get Domain/Link Statistics by Interval), the Top Values operations and Get Link Clicks
  count human clicks only by default; the plain click totals (clicks/totalClicks from Get
  Domain/Link Statistics) count all clicks, bots included.

Excluded

These Short.io endpoints and features are intentionally not implemented:

Compatibility

Requires n8n 1.x or later with community nodes enabled. Built and tested with Node.js 24.

Usage terms

Use of this node is subject to Short.io's Terms of Service and the
limits of your Short.io plan. See the Short.io API documentation
for the full reference this node is built against.

Resources

• n8n community nodes documentation
• Short.io API documentation
• Short.io API key setup

Version history

Versions follow YYYY.M.PATCH, set from the git tag at publish time.

• 2026.9.1 — No functional changes. First release published through npm Trusted
  Publishing (OIDC) instead of an access token.
• 2026.9.0 — Initial release: the Short.io node (Domain, Folder, Link, Link Country
  Targeting, Link OpenGraph, Link Permission, Link Region Targeting, Statistic) and the Short.io
  Trigger (New Link, New Click).

License

MIT