Skip to main content

QR Scan Notifications

What it is​

When a recipient scans the QR code on a mailer, thanks.io can notify you instantly via:

  • Email - a notification to your account email with the recipient's name, address, and scan timestamp. To CC additional recipients on these emails, add them to the Message Template.
  • SMS/Text - a text message to your registered phone number
  • Webhook - a POST request to your configured endpoint with the full scan event payload

How to configure notifications​

  1. Click the gear icon (⚙️) in the top right to open Account Settings. Email and SMS toggles are in the Notifications section.
  2. For webhooks, click the Webhooks tab, enter your endpoint URL, and optionally configure a signing secret.
  3. Save.

Webhook payload​

The scan webhook payload includes:

  • Recipient name and address
  • Source mailing list and campaign
  • Scan timestamp
  • QR destination URL scanned
  • Thanks.io recipient ID (for CRM correlation)

See Webhooks for the full payload schema and verification guide.

Tips & best practices​

  • Enable email notifications for high-value campaigns (real estate, VIP clients) so you can follow up personally within minutes of a scan.
  • For high-volume campaigns, use webhooks to push scan events into your CRM automatically rather than receiving individual emails.
  • Webhook delivery is at-least-once - build idempotent consumers to handle duplicate delivery.
  • Test your webhook endpoint with a preview scan before launching a campaign.

Limits & gotchas​

  • SMS notifications require a registered phone number in your account settings.
  • Webhook payload format may evolve - subscribe to the thanks.io changelog to stay informed.