Receive webhooks on scan

RecodeQR allows you to receive real-time notifications via webhooks whenever one of your dynamic QR codes is scanned.

Important: Enabling webhooks forwards scan data for all dynamic QR codes in your workspace to the defined URL.

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 dynamic 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",
            "destination": "link", // The destination type (eg. link, sms, email)
            "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.

Use cases and ideas

QR code scan webhooks open up a wide range of integrations and automations. Here are some common ways teams use them:

Real-time notifications

Get instant alerts when a QR code is scanned. Send a Slack or Microsoft Teams message to your team whenever a scan happens, so you know the moment someone interacts with your campaign material, product packaging, or event signage.

CRM and lead tracking

Feed scan data directly into your CRM (such as Salesforce or HubSpot). When a QR code on a business card, brochure, or trade show booth is scanned, automatically create or update a lead record with the scan's location, device, and timestamp.

Custom analytics dashboards

Build your own analytics pipeline by forwarding scan events to tools like Google BigQuery, Mixpanel, or your own database. Combine QR scan data with other marketing metrics for a unified view of campaign performance across channels.

Inventory and asset tracking

Attach QR codes to physical assets, equipment, or inventory items. Each scan can trigger a log entry in your asset management system, helping you track when and where items are checked, moved, or inspected.

Event check-in and attendance

Use QR codes on event tickets or badges. When scanned at the door, the webhook can notify your event management system to mark attendees as checked in, update headcounts in real time, and trigger welcome emails or SMS messages.

Workflow automation with Zapier, Make, or n8n

Point your webhook URL at a Zapier, Make (Integromat), or n8n webhook trigger to connect QR code scans to thousands of apps without writing code. For example, log every scan to a Google Sheet, send a personalized email to a customer, or add a task to your project management tool.

Order and fulfillment triggers

Place QR codes on product packaging or shipping labels. When a customer scans the code, the webhook can notify your fulfillment or support system that the package was received, trigger a feedback survey, or kick off a warranty registration flow.

Access control and verification

Use scan webhooks to verify physical access. When a QR code at a secure location is scanned, your backend can validate the request and log the access event, useful for offices, co-working spaces, or restricted areas.

Location-based marketing

Since each scan includes geographic data (country, region, and city), you can trigger location-specific actions. Serve different content, send targeted follow-ups, or adjust campaigns based on where your QR codes are actually being scanned.

Connecting to your own API or backend

For developers, the webhook is a straightforward way to react to scans in your own application. Parse the JSON payload in any language or framework, and build custom logic - whether that's updating a database, calling a third-party API, or triggering a background job.

Need help with setup? Contact support - we're here for you.