Receive webhooks on scan

RecodeQR allows you to receive real-time notifications via webhooks whenever one of your QR codes is scanned. This enables you to integrate QR code scan data with your own applications and workflows, triggering automations or custom analytics.

This feature requires the Business plan.

Set up your webhook URL

1. Navigate to Workspace Settings > Webhooks in your RecodeQR dashboard.

2. Enter the full URL of your endpoint that will receive the webhook data (e.g., https://yourserver.com/recodeqr-webhook).

3. Save the changes.

To remove or disable the webhook, clear the Webhook URL field by making it empty and then save the changes.

Example webhook payload

RecodeQR will then send a POST request with a JSON payload to your specified URL each time one of your QR codes is scanned. The webhook is sent asynchronously, so it won't delay the redirect for the user scanning the QR code.

{
    "event": "qr_code.scanned",
    "timestamp": "2025-03-20T21:54:31.374739Z", // ISO 8601 timestamp of the webhook event
    "data": {
        "qr_code": {
            "code_id": "qr_Jph62xQPGti",
            "name": "Test QR Code Name",
            "dynamic_url": "http://your.domain.com/c/123456",
            "total_scans": 457 // Total number of scans for this QR code
        },
        "scan_record": {
            "timestamp": "2025-03-20T21:54:31.374739Z", // ISO 8601 timestamp of the actual scan
            "country_code": "DE", // Two-letter country code
            "region_name": "Bavaria", // Region or state name (if available)
            "city_name": "Munich", // City name (if available)
            "device": "Other", // e.g., Phone, Tablet, Desktop, Other
            "os": "Windows", // e.g., Android, iOS, Windows, macOS, Linux
            "browser": "Chrome", // e.g., Chrome, Safari, Firefox
            "language": "en", // Language code from the scanner's browser
            "utm_source": null, // UTM source from the QR code's destination URL
            "utm_medium": null, // UTM medium
            "utm_campaign": "summer", // UTM campaign
            "utm_content": null, // UTM content
            "utm_term": null // UTM term
        }
    }
}

Testing your webhook

You can inspect the incoming webhooks using a tool like UseWebhook. This tools allows you to create a temporary endpoint that captures incoming requests, so you can see the exact payload RecodeQR sends.

Need help with setup? Contact support — we’re here for you.