Explore it here: linklyhq.com/url-shortener-api-reference

Run in Postman →

npm install -g @linkly-link-shortener/cli
linkly auth login

Sign in with OAuth (browser) or an API key — credentials are saved locally so you only authenticate once. Add --json to any command for machine-readable output, or run linkly schema to print the full command tree for use with AI agents and scripts.

Read the full documentation →

Notifications include the link name, short URL, country, browser, and a link straight to the analytics dashboard. Debouncing applies as normal: at most one notification per link every 15 minutes, and bot clicks are excluded.

After installing, the setup page walks you through the next step: run /linkly notify in your chosen Slack channel to activate notifications. You can also type /linkly in Slack at any time to see all available commands.

Learn more about Slack click notifications.

What's in it

• /shorten <url> — create a branded short link in one command. Add <domain>/<slug> to pick the exact short URL.
• /clicks <domain/slug> — see total clicks and last-7-day stats, with a button into the full analytics dashboard.
• /qr <domain/slug> — get a scannable QR code rendered right in the channel.
• App Home — at-a-glance view of your connected Linkly workspace, default short-link domain, and dashboard shortcuts.

Three minimal bot scopes: commands, chat:write, im:write. No message-history or DM-history access.

Full details: Slack integration docs.

Existing customers are grandfathered. If you're already paying for Linkly, nothing changes — you keep your current plan and pricing for now.

We've also added new Zap templates for Google Sheets, Slack, RSS, WordPress and Mailchimp, covering the most-asked-for workflows: shortening URLs in bulk, getting Slack alerts on link clicks, and logging click data to Google Sheets.

See the integration →

We've also reworked the layout to be easier to scan: the destination, short link, and nickname sit together at the top, with targeting and tracking & analytics options grouped underneath. The QR code, recent clicks, and link preview now share a single side panel.

Open Linkly in ChatGPT →

What You Can Do

Once connected, just ask ChatGPT to:

• Shorten URLs - "Shorten this URL: example.com/my-long-page"
• Create QR codes - "Make a QR code for my website"
• Track clicks - "How many clicks did my last link get?"
• Manage links - "List my recent links"

Getting Started

Open go.linklyhq.com/chatgpt, sign in to your Linkly account when prompted, and start chatting.

This is now our recommended way to use Linkly with ChatGPT. See the full setup guide for more.

When Claude Desktop, Claude Code, or any other MCP-compatible client connects for the first time, a browser window opens asking you to sign in to Linkly and approve access. After that, your assistant stays connected with a workspace-scoped token, and the model itself never sees your credentials.

For Claude Desktop, the config is now just:

{
  "mcpServers": {
    "linkly": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.linklyhq.com"]
    }
  }
}

See the updated setup guide for full instructions.

To enable push notifications, go to Account Settings and toggle on Browser Notifications. Once enabled, any link with click notifications turned on will also send push notifications to your device. Clicking a notification takes you directly to that link's traffic report.

Push notifications work in Chrome, Safari, Firefox, and Edge. They use the same 15-minute debouncing as email notifications. Learn more about click notifications.

In the link editor, expand the TikTok Pixel section, enter your Pixel ID, and save. When someone clicks the link, the TikTok Pixel fires automatically before they're redirected to the destination.

This works alongside the existing Meta Pixel and Google Analytics integrations. You can use all of them on the same link.

See 'Add TikTok Pixel to a Link' for the full guide.

In the QR code editor, next to the Upload button in the Logo row, you'll see a small icon showing the favicon of your link's destination. Click it to instantly set it as the QR code logo — no need to download and re-upload the image yourself.

This makes it quick and easy to create branded QR codes that match the destination site.

When you paste a wa.me URL into the destination field (or just type wa.me), a form pops out with separate Phone number and Message fields, along with a live preview showing how the message will appear in WhatsApp.

This means you can:

• Edit the phone number and message without manually URL-encoding the text parameter
• See a live preview of the WhatsApp chat as you type
• Track every click with full Linkly analytics — location, device, referrer, and more

All existing Linkly features work with WhatsApp links, including custom domains, retargeting pixels, UTM tags, expiry dates, and A/B rotation.

See 'WhatsApp Link Generator' for the full guide.

This feature doesn't change the underlying image.

When adding a domain in the wizard, if your DNS provider supports Domain Connect, you'll see an Auto-Configure option. Click it, authorize the changes at your provider, and Linkly will set up the correct CNAME or A records for you — no manual DNS editing required.

Supported DNS providers include:

• Cloudflare
• GoDaddy
• IONOS
• NameSilo
• Plesk
• WordPress.com

For more details, see our custom domain setup guide.

This is a dramatic upgrade which should reduce global redirect times and increase capacity for traffic surges.

Icons are also shown when detected when entering URLs.

https://lnk.ly/ABC123.qr.png

This returns a PNG image of the QR code, complete with any saved styles, colors, and logos. No authentication is required, making it easy to embed QR codes in emails, documents, or webpages using a simple <img> tag.

For developers who need more control, an authenticated API endpoint is also available at /api/v1/link/:id/qr/png, which supports query parameter overrides for colors, styles, and size.

See 'QR Code Generator API' for full documentation.

Refreshed sidebar - The navigation sidebar has been updated with a sleek dark theme, clearer icons, and better visual hierarchy so you can find what you need faster.

Sparkline previews - Each link now shows a mini traffic sparkline directly in the table, giving you an at-a-glance view of recent click activity without opening the full report.

Inline QR codes - QR codes are now displayed as thumbnails alongside each link, making it easy to identify and download them.

Streamlined toolbar - Column visibility and data export controls are now accessible from a clean toolbar at the top of the table.

Faster page loads - The dashboard now loads key data earlier and defers non-essential scripts, so you'll see your links and analytics faster than before.

Manage workspaces in-app - You can now create new workspaces and rename existing ones without leaving the dashboard. No more page reloads or context switching.

Smaller downloads - We've reduced the amount of data your browser needs to download on each visit, which is especially helpful on slower connections.

Supported Languages

• English
• Spanish (Español)
• French (Français)
• German (Deutsch)
• Portuguese (Português)
• Italian (Italiano)
• Dutch (Nederlands)
• Japanese (日本語)
• Korean (한국어)
• Chinese (中文)
• Polish (Polski)

Your language is automatically selected based on your browser settings, or you can switch manually using the language selector in the navigation bar.

Notifications include the link name, destination, country, browser, and platform of each click. To keep your inbox manageable, emails are automatically debounced to at most one per link every 15 minutes, and bot clicks are filtered out.

Click notifications are also available via the API using the notify_user_ids field. Learn more about click notifications.

Supported Languages

• English
• Spanish (Español)
• French (Français)
• German (Deutsch)
• Portuguese (Português)
• Italian (Italiano)
• Dutch (Nederlands)
• Japanese (日本語)
• Korean (한국어)
• Chinese (中文)

What's Translated

All support articles, blog posts, and feature pages are now available in each language. The language is automatically selected based on your browser settings, or you can switch manually using the language selector in the navigation bar.

Localized Links

Internal links throughout the documentation are fully localized, so you'll stay in your chosen language as you navigate between pages.

When a link expires, visitors are either redirected to a destination of your choice, or shown a dedicated "link expired" page.

Click-based expiry is available in the dashboard, via the API, and through our Zapier integration. Learn more about expiring links.

Use the new exclude button (×) next to any ISP in the ISP tab to hide that traffic from your reports. Excluded ISPs appear with a strikethrough and can be easily re-included with one click.

You can also exclude multiple ISPs at once, and mix inclusions with exclusions for precise filtering.

The new Export Data dropdown in the traffic report gives you quick access to:

• By Link - All links in one file with clicks broken down by date (recommended)
• Totals - Aggregate daily totals across all links
• Raw Click Data - Individual click records with full details
• BigQuery - Direct SQL access for advanced analysis
• Webhooks - Real-time click notifications

Export as CSV for spreadsheets, or use the Google Sheets option to paste a live data feed formula that automatically updates.

See the Analytics API documentation for details on the new pivot=link_id parameter.

The new design features a bold, modern "L" icon with our signature orange, red, and blue colors, paired with clean typography.

You'll see the new logo rolling out across the Linkly dashboard, browser extension, and all our integrations over the coming weeks.

Here's to a great 2026!

Make (formerly Integromat) is a popular automation platform that lets you connect apps and build workflows visually without code.

What You Can Do

With the Linkly Make integration, you can:

• Create new shortlinks with full configuration (UTM parameters, tracking pixels, Open Graph metadata, and more)
• Update existing links by ID
• Delete links when no longer needed
• Get link details for use in other scenario steps
• List all links in your workspace
• Watch clicks instantly when any link is clicked (instant trigger)

Getting Started

In Make, search for "Linkly" when adding a new module to your scenario. Connect your Linkly account using your API key from your workspace settings.

Find the Linkly integration on Make

Check out our full documentation for setup instructions and use cases.

We've adapted this and now URLs fully support commas in Linkly.

Why We're Making This Change

As Linkly has grown, so have the costs of running our analytics infrastructure. A small number of accounts have been making extremely intensive API requests, which impacts performance and costs for everyone. These limits ensure fair access while keeping the service sustainable.

What's Changing

The Analytics API now has usage limits that reset each billing period:

• Free Plan: 100 requests / month, 10 GB data scanned / month
• Monthly Paid: 2,000 requests / month, 2 TB data scanned / month
• Annual Paid: 24,000 requests / year, 24 TB data scanned / year

Rate limits are also in place: 50 requests per hour per workspace.

What This Means For You

Most users won't notice any change. These limits are designed to only affect the most intensive usage patterns. If you're using the API for standard reporting and data export, you're unlikely to hit these limits.

Monitoring Your Usage

You can monitor your API usage in the Billing section of your account settings. This shows your current usage against your limits.

Need Higher Limits?

If you need more capacity for your application, please talk to us using the support widget. We're happy to discuss options for high-volume use cases.

Alternatives for Heavy Usage

For customers with intensive analytics needs, consider our BigQuery Integration, which provides direct SQL access to your click data without API rate limits.

For full details, see the Analytics API documentation.

Linkly now has an embedded spreadsheet which allows you to manage your imports visually.

Linkly's old CSV upload continues to be available is linked from the navbar at the top of the spreadsheet.

This feature is a beta and we welcome feedback from users.

What You Can Do

Once connected, simply ask Claude to:

• Create links - "Create a short link for https://example.com with UTM source twitter"
• View analytics - "How many clicks did my links get this week?"
• Update links - "Change the destination of my promo link"
• Search links - "Find all links related to the product launch"
• Manage webhooks - "Set up a webhook for click notifications"

Getting Started

1. Get your API key from Settings → API in Linkly
2. Add the Linkly MCP server to your Claude Desktop config
3. Start chatting!

Check out our full setup guide for detailed instructions.

n8n is a flexible workflow automation platform similar to Zapier, with the added benefit of self-hosting options and a visual workflow builder.

What You Can Do

With the Linkly n8n node, you can:

• Create new shortlinks with full configuration (UTM parameters, tracking pixels, Open Graph metadata, and more)
• Update existing links by ID
• Delete links when no longer needed
• Get link details for use in other workflow steps
• Trigger workflows instantly when any link (or a specific link) is clicked

Getting Started

Install the Linkly node from n8n's community nodes: Settings > Community Nodes > Search for "linkly"

Or via npm: npm install @linkly-link-shortener/n8n-nodes-linkly

Check out our full documentation for setup instructions and use cases.

New triggers:

• Any Link Clicked (⚡ Instant) - fires immediately when any link in your workspace is clicked
• Specific Link Clicked (⚡ Instant) - fires immediately when a specific link is clicked

Click events now trigger in real-time instead of polling every 15 minutes.

Configure webhooks per-link or workspace-wide in Settings. Payloads include country, device, browser, referer, and UTM parameters.

See the webhooks documentation for setup details.

• Press Ctrl/Cmd+Enter on the dashboard to create a new link.
• Press Ctrl/Cmd+Enter on the new link form to save a link.
• Press Escape anywhere to return to the dashboard.
• Press Ctrl/Cmd+K to search the links.

View the complete keyboard shortcuts reference guide for more details.

This also applies to all API endpoints and Google Sheets.

It's also fully integrated with timezone support.

If you also enable "ignore social crawlers," it will permit these through and not track them, even if block robots is enabled.

The options are now pass through referrers, or to hide them entirely.

This will reduce the number of malicious clicks on root domains attached to Linkly.

We have added response times, monitoring for separate services and endpoints.

We are continuing to roll out backend improvements that will improve reliability for our customers.

You can see our current uptime at https://status.linklyhq.com.

Now, when traffic from these servers hits your links, it isn't recorded and it doesn't count against click limits.

However, the robot is transparently redirected to the correct destination.

We now also always permit these crawlers through even when the block robots feature is being used.

This improves a scenario where users are heavy users of social networks and find their click limits would be consumed by social media crawlers.

Learn more about bot traffic →