For developers · beta, free for everyone

Webhooks for
short links

You create a link or someone follows it, and your URL gets a POST with the event data. It is a plain request with no authorization.

Setup

How to add a webhook

One webhook has one event and one URL. You can add more than one webhook. Create links on the home page, in your dashboard, or through the API.

Add a webhook

Events

When a request arrives

link.created

You created a short link. The payload has all its fields.

link.visited

Someone opened the link. The payload has the visitor data.

Format

What your URL receives

A form-urlencoded POST with no authorization. There are four fields. The event data is a JSON string in data[payload].

event          link.created or link.visited
ts             event time, Unix timestamp
data[id]       id of the link (link.created) or of the visit (link.visited)
data[payload]  JSON string with the link or visit fields

Example payload for link.created

{
  "id": 126,
  "destination_url": "https://example.com/page",
  "default_short_url": "https://lnk.ua/XHxu0jKaP",
  "url_key": "XHxu0jKaP",
  "created_at": "2026-11-16T13:57:30.000000Z"
}

Example payload for link.visited

{
  "id": 106,
  "short_url_id": 126,
  "visited_at": "2026-11-16T13:57:30.000000Z",
  "ip_address": "203.0.113.7",
  "operating_system": "OS X",
  "browser": "Chrome",
  "browser_version": "120",
  "device_type": "desktop",
  "referer_url": "https://t.me/"
}

Delivery

Answer with 200

After an HTTP 200 the request counts as delivered. On any other response we send the request again a few more times.

Answer right away

link.visited comes on every visit, bots included. A link with heavy traffic means many requests, so do the processing after the response.

FAQ

Webhooks are part of PRO. During the beta they are free for everyone. The prices are on the pricing page.

The request has no signature. Add a secret to the webhook URL, for example https://example.com/hook?secret=abc123, and compare it on your server. Reject a request with a different secret.

In form-urlencoded every value becomes a string, and empty values are lost. In a JSON string a number stays a number and null stays null. Parse the string as JSON; in PHP that is json_decode.

Yes, link.visited comes on every visit and we do not filter bots. If they get in the way, filter them on your side: the payload has the IP, the browser and the device type.

Yes. Add several webhooks with that event and give each one its own URL.

Delete it in your dashboard, under "Settings → Webhooks". If you need it again, add it again.

Add your first webhook

Add a webhook