Back to help
12

Automations and notifications

Webhooks help react to link events automatically by sending an event notification to another service chosen by the owner. Owners can configure notifications for the first click, every click, an exact click count, every Nth click, important milestones such as 100 clicks, and expiration. Conversion tracking can be recorded by a tracking pixel, which is a tiny page element used to confirm that a visitor reached a target page, or by sending an event through approved integration access. This makes it possible to connect clk.ms links with reporting dashboards, CRM workflows, alerts, or campaign automation.

Conversions, webhooks and notifications

Pixel and Conversion API

In the integrations tab, copy the address of the pixel with the token. Place it on the successful completion of the desired action page, and not on all pages of the site. If the Thank You page is reopened, the pixel may record a repeat event: There is no automatic order deduplication.

The pixel returns a 1x1 transparent image. Parameters eventName and value specify the name and numeric value of the event. For example:

<img src="https://clk.ms/api/links/sale-2026/conversions/pixel?token=YOUR_TRACKING_TOKEN&amp;eventName=signup" width="1" height="1" alt="">

Use the real address from your card and your token. The given example with a placeholder does not record the event. A blocker, the target site's security policy, or failure to load the image may prevent recording. A response with an image does not in itself confirm a successful conversion: the pixel returns an image even in some rejected events. Check the entry in the link activity.

For server integration, you can send a JSON event:

POST /api/links/sale-2026/conversions Content-Type: application/json X-Clk-Conversion-Token: YOUR_TRACKING_TOKEN

{"eventName":"purchase","value":149.90,"metadataJson":"{\"orderId\":\"demo-123\"}"}

metadataJson - a string with a valid JSON object, up to 4096 characters, with a depth of up to 16. Do not transmit payment details or secrets. The numerical value is limited to the range −10¹⁵ to 10¹⁵. Check the successful response recorded: true; Validation errors, invalid token, and unreachable link are not recorded events. Requests are limited to 300 per minute per IP and link ID combination.

The conversion token allows events to be sent and is not a commercial API token or report password. Store it according to the integration method; in a pixel it is inevitably visible to the page visitor.

Webhooks

Webhook sends an HTTP POST with JSON to your handler. In the link card → «Integrations», set the event, mode, if necessary, the number of clicks on the link and the HTTPS address, then save.

Event/Mode — When to use click + every_click — Every link click that counts click + exact_click — When the total counter reaches exactly the specified value click + every_nth_click — When the total counter is a multiple of the specified number expired — When processing a terminated link

Example request body:

{"eventType":"click","linkId":123,"shortCode":"sale-2026","useCount":10,"occurredAtUtc":"2026-09-06T12:00:00Z"}

The handler must be accessible via HTTPS from the outside. Local, private and other prohibited network addresses are not suitable. Return successful HTTP status quickly; Do long-term work separately. Do not use automatic opening of someone else's page as a replacement for your own webhook handler.

In the webhooks table you can check the last delivery time, HTTP status and error, temporarily disable the handler or delete it. The counter value applies to the link as a whole: enabling exact_click=3 when there have already been ten clicks on the link does not trigger the event retroactively.

The current protocol does not add an HMAC body signature and does not provide re-delivery settings in the interface. Don't base a critical operation on the assumption of guaranteed delivery exactly once. Take this into account when designing the receiver and match the events with the link data. Webhook click is not a conversion notification.

Notifications to owner

In your profile, you can enable notifications of clicks via email and Telegram, exclusion of bots, and a minimum interval between messages. For Telegram, the chat identifiers and, if necessary, topics available in the form are specified. The bot must be able to send messages to this chat; specifying an arbitrary username does not replace the required identifier.

Save your settings, make one real click on the link and check your receipt. The absence of a message may be due to a minimum interval, a bot filter, a disabled channel, or a problem with an external delivery service. Notifications do not replace the statistics of all link clicks. The routing simulator does not send notifications.

Complete user guide ยท Practical course

How to apply this section

Each topic explains a feature, the user decision behind it, and how to use it without making the link harder to manage. Read the checklist before changing a link that is already shared.

Before you publish or update

  • Start from the visitor experience: who opens the link, from where, on which device, and what should happen next.
  • Check that the destination is correct, opens quickly, and shows the expected page for the intended audience.
  • Choose only the controls that match the goal, such as expiration, password, referrer, QR design, UTM, routing, or analytics sharing.
  • Save a short note for important changes so future review, rollback, or teamwork stays clear.
  • Open the short link in a private browser session and, when relevant, test mobile, desktop, QR scan, and protected access paths.
  • Review analytics after sharing to confirm real visitors, source quality, device mix, and campaign performance.

Practical example

Example: create a test link for an internal page, add a clear slug, set a short expiration, enable preview if the destination is sensitive, scan the QR code from a phone, then check whether the visit appears in the link statistics.

Next step

After this topic is clear, combine it with one adjacent feature. For example, pair UTM with campaigns, QR with print layouts, targeting with fallback, or webhooks with conversion tracking.