Make a short link

links_shorten · Changes data · Markdown

A short link at cncto.co/<code> that sends people on and counts the clicks.

$0.01 a call

From your agent’s balance. A call that fails costs nothing.

Make a short link for the autumn flyer that goes to the gravel bikes, something like cncto.co/autumn-sale.

Your agent callslinks_shorten$0.01 a call

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

{
  "url": "https://halversoncycle.example/bikes/gravel?utm_source=flyer&utm_campaign=autumn-sale",
  "alias": "autumn-sale",
  "title": "Flyer, October"
}

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

A long address goes into a message, a flyer or a QR code, and the clicks should be counted.

What it does

A short link at cncto.co/<code> that sends people to url and counts the clicks, for messages, print and QR codes. Give alias for a readable one (cncto.co/spring-sale) or leave it out for a random 7-character code. The destination can be changed later; a deleted link's code is never reused. Needs an account that has topped up once.

What comes back

The link: code, short_url, url, title, paused, blocked, clicks, last_clicked_at and created_at. Every reply also carries cost_usd and balance_usd.

Inputs

Name	Type	What it is
`url`Required	string	Where it goes: https://... 8 to 2,000 characters.
`alias`	string	Lower-case letters, digits and dashes, e.g. "spring-sale". 3 to 40 characters.
`title`	string	A note for yourself, e.g. "Flyer, October". Up to 200 characters.

The call

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

Terminal

curl -X POST https://api.conecto.chat/v1/tools/links_shorten \
  -H "Authorization: Bearer $CONECTO_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://halversoncycle.example/bikes/gravel?utm_source=flyer&utm_campaign=autumn-sale","alias":"autumn-sale","title":"Flyer, October"}'

When it refuses

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

Code	When	What to do
`payment_required`402	The business has never topped up; short links need one real top-up.	Top up once (POST /v1/topups).
`invalid_input`400	The url is not an http(s) address with a full domain, points at a short link, or is not on the public internet.	Send a full address like https://halversoncycle.example/bikes.
`invalid_input`400	The alias is not 3 to 40 lower-case letters, digits and single dashes.	Send an alias like "autumn-sale", or leave it out for a random code.
`alias_taken`409	Someone already has that alias.	Pick another alias, or leave it out.
`limit_reached`409	The business has as many short links as it may.	Delete old ones with links_delete.
`conflict`409	No free random code was found.	Call again.

Give this to your agent.

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

Make a short link

An example

Use it when

What it does

What comes back

Inputs

The call

When it refuses

More Links & QR codes tools

Give this to your agent.