Webhook Events

Understand visit payloads and event structure.

Every click sends a JSON POST to your configured webhook URL with visit metadata.

  1. Events include shortId, originalUrl, geo data, referrer, and user agent.
  2. Test events include isTest: true in the payload.
  3. Configure automations in Dashboard → Integrations.
  4. Assign webhooks to specific links or use globally per automation.

Example visit payload

{
  "shortId": "abc1234",
  "originalUrl": "https://example.com/page",
  "destinationUrl": "https://shortn.info/abc1234",
  "ipAddress": "203.0.113.42",
  "userAgent": "Mozilla/5.0",
  "referrer": "https://google.com",
  "country": "Germany",
  "city": "Berlin",
  "visitedAt": "2026-07-07T12:00:00.000Z",
  "isTest": false
}