Links & QR codes

Make a QR code

qr_create · Changes data · Markdown

A QR code for a link or any text, saved in the file store as a PNG or SVG with a download link.

$0.01 a call

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

An example

Make a QR code for our price tags that opens the bike fitting booking page.

Your agent callsqr_create$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
{
  "data": "https://cncto.co/book/halverson-cycle/bike-fitting",
  "name": "Price tag QR code",
  "format": "png",
  "size": 1024,
  "dark": "#1f4d3a"
}
What comes back
{
  "file": {
    "file_id": "62fe7ad2-f22c-4eea-a42f-2b0f665a2304",
    "name": "Price tag QR code.png",
    "content_type": "image/png",
    "size": "5.4 KB",
    "size_bytes": 5564,
    "sha256": "7bdc9eefa58f52bc4c215ded3b65ccf077ac9f12fb243bbbd17bf4c403cca3b9",
    "created_at": "2026-10-14T08:00:00+00:00",
    "download_url": "https://cncto.co/d/62fe7ad2-f22c-4eea-a42f-2b0f665a2304?t=eyJmIjoiNjJmZTdhZDItZjIyYy00ZWVhLWE0MmYtMmIwZjY2NWEyMzA0IiwiZXhwIjoxNzkyMTU5NTE0fQ:1xHM54:DgdCsnH7Z9dfOPh-FPGj4yJGu9mRj_jn2Xc3ebCCzkE",
    "link_expires_in_hours": 24
  },
  "modules": 33
}

Use it when

Something printed (a price tag, a flyer, a receipt) should open a page or hold text.

What it does

A QR code for a link or any text (a payment link, a booking page, Wi-Fi details), saved in the file store as PNG or SVG with a download link. Dark modules must contrast with the background so phones can read it.

What comes back

The file (file_id, name, type, size, download link and when the link expires) and the number of modules across the code. Every reply also carries cost_usd and balance_usd.

Inputs

NameTypeWhat it is
dataRequiredstring1 to 2,000 characters.
namestringFile name; defaults to "QR code". Up to 200 characters.
formatstringOne of: png,svg. Default: png.
sizeintegerPNG width and height in pixels. 128 to 2,048. Default: 1024.
darkstringMatches ^#[0-9a-fA-F]{6}$. Default: #171717.
lightstringMatches ^#[0-9a-fA-F]{6}$. Default: #ffffff.
error_correctionstringHigher survives damage or a logo on top, at the cost of density. One of: low,medium,quartile,high. Default: medium.

The call

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

Terminal
curl -X POST https://api.conecto.chat/v1/tools/qr_create \
  -H "Authorization: Bearer $CONECTO_KEY" \
  -H "Content-Type: application/json" \
  -d '{"data":"https://cncto.co/book/halverson-cycle/bike-fitting","name":"Price tag QR code","format":"png","size":1024,"dark":"#1f4d3a"}'

When it refuses

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

CodeWhenWhat to do
low_contrast400The dark and light colours are too close for phones to read.Use a darker dark colour or a lighter light one.
too_long400There is too much data for one QR code.Shorten it, for example with links_shorten.
storage_full409The file store has no room for the image.Delete files with files_delete, or add room with files_add_storage.

Give this to your agent.

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