Linkly for Dify

Author: Linkly Ltd (linkly-hq)
Version: 0.1.0
Type: Tool plugin
Source: https://github.com/Linkly-HQ/linkly-dify-plugin
Support: [email protected]

Linkly is a URL shortener with click tracking: branded short links on your own domain, UTM tagging, retargeting pixels, link rotators and detailed click analytics. This plugin lets Dify agents, chatflows and workflows create and inspect Linkly links and read their analytics through the public Linkly API.

Setup

Sign up at https://linklyhq.com (the free plan works with the API).
In the Linkly app open Settings > API (https://app.linklyhq.com/app/user/api) and copy your API key. Note the workspace ID shown on the same page.
In Dify go to Plugins > Linkly > Authorize and paste the API key. The workspace ID is optional; leave it blank to use the first workspace the key can access.

Connection requirements: the plugin connects over HTTPS to the Linkly API endpoint (base URL), authenticating with the API key as a Bearer token. No other outbound connections are made.

Tools

Tool	What it does
	Create a short link for a destination URL. Optional name, custom slug, branded domain, note and UTM parameters. Returns the short URL and link ID.
	Fetch a link by ID: destination, short URL, settings and click totals.
	List or search links in the workspace, with paging and sorting (for example by ).
	Time-series click counts for the workspace or one link, by day or hour, optionally unique clicks only or excluding bots.
	Clicks grouped by one dimension: country, city, region, platform, referrer, destination, ISP, bot name, link, or any UTM tag.
	List the custom domains available for short links in the workspace.
	Permanently delete a link by ID.

Usage examples

Agent: "Shorten https://example.com/spring-sale on our brand domain and tag it utm_source=newsletter" - the agent calls and returns the short URL.
Workflow: a node after a content-generation node, so every generated post carries a tracked short link.
Reporting: with for the last 30 days, fed into an LLM node for a summary.

Notes

Dates for the analytics tools use (or ISO 8601 with time).
is permanent. Deleted links can only be restored from the Linkly app.
The plugin is stateless and stores nothing; see PRIVACY.md.

Development

Issues and pull requests: https://github.com/Linkly-HQ/linkly-dify-plugin

License

MIT - Linkly Ltd