conecto. Get started
Links & QR codes

List short links

links_list · Reads only · Markdown

The business's short links, newest first, with their clicks.

Free*

*Free up to 1,000,000 reads a month for the whole account, then $0.50 per 10,000 reads.

An example

Which of our short links got the most clicks this month?

Your agent callslinks_listFree*

The example business is Halverson Cycle & Repair, a bike shop with a repair workshop in Portland, Oregon. The reply is the one the tool really gives.

With these arguments
{
  "limit": 50
}
What comes back
{
  "links": [
    {
      "code": "summer-sale",
      "short_url": "https://cncto.co/summer-sale",
      "url": "https://halversoncycle.example/summer?utm_source=flyer",
      "title": "Flyer, June 2025",
      "paused": false,
      "blocked": false,
      "clicks": 0,
      "last_clicked_at": null,
      "created_at": "2026-10-14T08:00:00+00:00"
    },
    {
      "code": "autumn-sale",
      "short_url": "https://cncto.co/autumn-sale",
      "url": "https://halversoncycle.example/bikes/gravel?utm_source=flyer&utm_campaign=autumn-sale",
      "title": "Flyer, October",
      "paused": false,
      "blocked": false,
      "clicks": 0,
      "last_clicked_at": null,
      "created_at": "2026-10-14T08:00:00+00:00"
    }
  ],
  "total": 2
}

Use it when

To find a link's code, or compare clicks between links.

What it does

This account's short links, newest first, with their clicks. query matches the code, title or address.

What comes back

The links, newest first, each with its code, short_url, url, title, state and clicks, and the total. Every reply also carries cost_usd and balance_usd.

Inputs

NameTypeWhat it is
querystringUp to 200 characters.
limitinteger1 to 200. Default: 50.
offsetintegerAt least 0. Default: 0.

The call

Over MCP, call links_list on https://api.conecto.chat/mcp/links. Over REST:

Terminal
curl -X POST https://api.conecto.chat/v1/tools/links_list \
  -H "Authorization: Bearer $CONECTO_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":50}'

More Links & QR codes tools

All 6 tools

Give this to your agent.

Set up Conecto from https://conecto.chat/SKILL.md