Webhooks

Webhook Events

Receive real-time notifications when QR codes are scanned. Reliable delivery with automatic retries.

Event Types

code.scannedFired every time a QR code is scanned by a user.

code.createdA new QR code was created via API or dashboard.

code.updatedA QR code's destination or settings were modified.

code.deletedA QR code was deleted.

scan.fraud_detectedA potentially fraudulent scan was blocked.

Example Payload

{
  "event": "code.scanned",
  "timestamp": "2026-02-18T14:32:00Z",
  "data": {
    "code_id": "qr_abc123",
    "scan_id": "scn_xyz789",
    "url": "https://example.com/promo",
    "location": { "country": "US", "city": "New York" },
    "device": { "os": "iOS", "browser": "Safari" },
    "ip_hash": "a1b2c3..."
  }
}