> ## Documentation Index
> Fetch the complete documentation index at: https://learn.biq.li/llms.txt
> Use this file to discover all available pages before exploring further.

# link.clicked

> Receive a verified human click and its resolved link.

Biqli sends `link.clicked` after a verified human click is persisted. Automated or rejected traffic does not produce the same event guarantee.

## Example payload

```json theme={null}
{
  "id": "evt_01m2exampleclicked0000000000",
  "event": "link.clicked",
  "createdAt": "2026-09-14T15:05:00+00:00",
  "data": {
    "click": {
      "id": "click_example_1842",
      "timestamp": "2026-09-14T15:04:59+00:00",
      "ip": "203.0.113.42",
      "country": "US",
      "city": "San Francisco",
      "region": "California",
      "browser": "Chrome",
      "browserVersion": "128",
      "platform": "Mac OS",
      "platformVersion": "14",
      "device": "desktop",
      "referrer": "https://example.com",
      "source": null
    },
    "link": {
      "id": "biq_lnk_01M2EXAMPLE00000000000000",
      "externalId": "campaign_1842",
      "name": "Autumn campaign",
      "url": "https://example.com/autumn",
      "shortUrl": "https://biq.li/autumn",
      "key": "autumn",
      "description": null,
      "active": true,
      "expiresAt": null,
      "workspaceId": "biq_ws_01M2EXAMPLE000000000000000",
      "createdAt": "2026-09-14T13:40:23+00:00",
      "updatedAt": "2026-09-14T13:40:23+00:00"
    }
  }
}
```

## Privacy and nullable values

The click payload includes the recorded IP address. Treat it as personal data, restrict access, and retain it only as long as your purpose requires.

Location, user-agent, referrer, and source fields can be `null` or unknown. Never make delivery acceptance depend on those optional enrichment fields.