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 webhookEvents
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.