Get a short link

links_get · Reads only · Markdown

One short link: where it goes, its clicks and the last click.

Free*

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

How many people have used the autumn flyer link so far?

Your agent callslinks_getFree*

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

{
  "code": "autumn-sale"
}

What comes back

{
  "link": {
    "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"
  }
}

Use it when

Someone asks how one link is doing.

What comes back

The link with its code, short_url, url, title, state, clicks and last click. Every reply also carries cost_usd and balance_usd.

Inputs

Name	Type	What it is
`code`Required	string	The code after cncto.co/, e.g. "x7Kp2Qa". 3 to 40 characters.

The call

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

Terminal

curl -X POST https://api.conecto.chat/v1/tools/links_get \
  -H "Authorization: Bearer $CONECTO_KEY" \
  -H "Content-Type: application/json" \
  -d '{"code":"autumn-sale"}'

When it refuses

A refused call costs nothing and says what to do next.

Code	When	What to do
`not_found`404	No short link of the business has that code.	Call links_list and use one of its codes.

Give this to your agent.

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

Get a short link

An example

Use it when

What comes back

Inputs

The call

When it refuses

More Links & QR codes tools

Give this to your agent.