Linkly
Analytics & DataCreate and track branded short links with Linkly, covering link management, custom domains, and click data. Agents mint a tracked link per campaign and read attribution back into reporting.
What This Integration Enables
The reason to run Linkly through an agent is that Linkly does not make you go and ask. On Link Clicked fires each time one of the workspace's links is hit, delivering the browser, platform, country, referrer and resolved destination with the link record attached. That turns a click from something you look up into something that starts a flow, which is the difference between a report and a workflow. On Link Changed covers the other direction, firing when a link is created, updated or deleted in the workspace, and the connector is honest about its cost: selecting Link Updated is noisy by design, because Linkly emits it on every save including partial and autosaved edits.
Around the event stream is a full link management surface. Agents create links with custom slugs and branded domains, UTM parameters, retargeting pixels, Open Graph overrides, expiry conditions and geo or device redirect rules. They read traffic back two ways, as a time series bucketed by day or hour through Get Click Timeseries, or grouped by a dimension such as country, platform, referrer or ISP through Get Click Counters, with bots excluded and clicks de-duplicated to unique visitors when that matters. Track Conversion closes the loop by recording a lead or a sale against the click that produced it. And because links get retired as well as created, Linkly keeps deleted links in a trash that Restore Links can pull back, reporting any slug that has since been claimed by another link rather than silently overwriting it.
Without FlowRunner
With FlowRunner
Use Case Scenarios
A click that reaches the rep while it still means something
An outbound sequence sends a proposal link. When the prospect opens it, On Link Clicked delivers the event within the polling window. The agent resolves the link's UTM values to an account in Pipedrive, collapses repeat clicks from the same visitor, and posts to the rep's channel in Slack with the account name, the asset opened and the country it was opened from. The rep is not reading a weekly digest. They are deciding whether to call now.
Attribution that survives contact with reporting
Clicks alone do not justify a budget. The agent calls Track Conversion when a lead form completes and again when the deal closes, passing amounts in minor currency units and an event ID so a retried run cannot double count. List Conversions then feeds the newest window of attributed events into a Google Sheets reporting tab alongside Get Click Counters grouped by referrer, so channel performance is measured in outcomes rather than in traffic. Negative amounts record refunds, which keeps the report honest when a deal unwinds.
Retiring a link without breaking something still in use
Housekeeping proposes removing links that look stale. The agent does the work first: Get Click Timeseries over the trailing window, Export Links to capture the current inventory as a backup, and a check of whether the slug appears in any active campaign record. Anything with recent traffic is separated out. What remains is proposed for retirement, with Update Link and Enabled turned off offered as the reversible alternative to a delete.
Human-in-Loop Highlight
Linkly can prove a link is still alive at the exact moment somebody wants to remove it, and that is what makes the gate here different from a generic approval. Delete Link is permanent: the short URL stops resolving immediately and the click history is removed with it. So when a cleanup flow reaches a candidate, the agent does not act on age. It pulls the trailing click evidence from its own event stream and puts it in the channel: "linklyhq link /q3-webinar is 9 months old and flagged for cleanup, but On Link Clicked has delivered 23 clicks in the last 7 days, mostly from the UK. Deleting removes the URL and its full click history. Disable it instead with Update Link, which keeps the history and can be reversed?" The person who knows whether that link is sitting in a live email footer answers, and the agent applies their choice. This is a digital andon cord with the evidence already attached: the agent does not just stop, it stops holding the reason. The gate covers Delete Domain on the same principle, since removing a branded domain stops every short link published on it from resolving, and the links in circulation do not know that is about to happen.
Agent Capabilities
16 actionsWorkspaces
1- List Workspaces Lists the Linkly workspaces the API key can access with their IDs and names. Almost every other operation needs a workspace ID, so this is the natural first call in a new flow.
Links
7- Create Link Creates a short link with an optional custom slug and branded domain, UTM parameters, retargeting pixels, Open Graph overrides, expiry conditions and geo or device redirect rules. Returns the full record including the ready-to-share short URL.
- Update Link Updates an existing link by ID, changing its destination, slug, name, tracking parameters or redirect rules. Only supplied fields are altered. Also the reversible way to retire a link, by turning Enabled off instead of deleting it.
- Get Link Retrieves one link by its numeric ID with its destination, slug, branded domain, tracking settings and redirect rules. Used to confirm configuration before changing or sharing it.
- List Links Lists links in a workspace with click totals for today, the last thirty days and all time, plus a sparkline of recent activity. Supports search, sorting, pagination and retrieval of soft-deleted links from the trash.
- Delete Link Permanently deletes a link. The short URL stops resolving immediately and its click history is removed.
- Restore Links Restores previously trashed links to active use. Any link whose slug and domain have since been claimed by another link is reported in the conflicts list rather than restored, so that list is worth reading after every run.
- Export Links Exports every link in a workspace as JSON or CSV, optionally narrowed by a search term. Used for backups, migrations and feeding link inventories into a sheet or warehouse.
Click Analytics
2- Get Click Timeseries Returns click counts bucketed by day or hour across a date range, optionally narrowed to specific links, countries, browsers, platforms, referrers or ISPs. Bots can be excluded and clicks de-duplicated to unique visitors.
- Get Click Counters Returns click totals grouped by a single dimension such as country, platform, referrer, destination or ISP, ordered from most to least. Results are capped at 10,000 groups but the returned total still counts every group, so percentage breakdowns stay accurate.
QR Codes
1- Get QR Code URL Builds the hosted QR image URL for an existing link, with styling for module shape, corner style, colours, size, margin and a centre logo. Linkly serves the PNG from its own CDN, so the URL can be embedded or downloaded without further authentication.
Branded Domains
3- List Domains Lists the branded short-link domains configured on a workspace. Used to confirm which domains are available before creating links on them.
- Create Domain Registers a branded short-link domain on a workspace. A CNAME record for the domain must already point at domains.linklyhq.com, otherwise links on it will not resolve.
- Delete Domain Removes a branded domain from a workspace. Links already published on that domain stop resolving, so retire them first if they are still in circulation.
Conversions
2- Track Conversion Records a conversion such as a lead or a sale against the click that produced it, using first-touch attribution. Sale amounts are in minor currency units and may be negative to record a refund. An event ID makes retries idempotent.
- List Conversions Lists the most recent conversion events, newest first, with the attributed click and link, event type, amount and metadata. Up to 1,000 per call with no offset, so this reads the newest window only.
Triggers
2 triggersEvent Triggers
2- On Link Clicked Fires each time one of the workspace's links is clicked, delivering the visiting browser, platform, country, referrer and resolved destination alongside the link that was hit. Used to stream click data into a warehouse, alert on campaign traffic, or enrich a CRM record the moment a prospect follows a link.
- On Link Changed Fires when a link in the workspace is created, updated or deleted, delivering the full record. Selecting Link Updated is noisy by design, because Linkly emits it on every save including partial and autosaved edits, so expect several deliveries during one editing session.
Frequently Asked Questions
What can FlowRunner do with Linkly?
FlowRunner agents can run List Workspaces, Create Link, and Update Link in Linkly, plus 13 more actions.
Does connecting Linkly to FlowRunner require OAuth?
No. Linkly connects to FlowRunner with an API key, no OAuth flow required.
Can Linkly trigger a FlowRunner workflow automatically?
Yes. Linkly supports 2 triggers that can start a FlowRunner workflow automatically.
Start building with Linkly
$100 in credits. No card required. Connect in minutes.