Question 1

What webhook events does Thanks.io fire?

Accepted Answer

Thanks.io fires webhooks for four event types: Order Status Change (when an order moves between statuses — e.g., submitted, in production, completed), Order Item Status Change (per-piece status updates), Order Item Delivered (when USPS confirms delivery via First Class tracking), and QR Code Scan (fired in real time when a recipient scans a QR code on a mailer).

Question 2

How do I configure a Thanks.io webhook?

Accepted Answer

Go to the Thanks.io dashboard, navigate to your Webhook settings, and add the destination URL for each event type. You can also configure webhooks programmatically via the REST API. After adding a webhook URL, use the built-in Test button to send a sample payload and verify your endpoint is receiving correctly.

Question 3

Are Thanks.io webhooks reliable?

Accepted Answer

Thanks.io webhooks are delivered at-least-once, meaning the same event may occasionally be sent more than once under failure conditions. Design your webhook consumer to be idempotent — safe to process the same event multiple times — and deduplicate on the event ID included in each payload.

Question 4

Can I trigger a CRM or marketing action from a QR scan webhook?

Accepted Answer

Yes. The QR scan webhook fires in real time when a recipient scans your mailer's QR code. You can point this webhook at Zapier, Make, n8n, or directly at your CRM's API to: update the contact record, enroll the lead in a new sequence, notify your sales team via Slack, or trigger any other action your system supports.

Question 5

Which plan is required for webhooks?

Accepted Answer

Webhooks require a Business or Professional plan. Business ($49/month) includes all webhook event types — order status, item delivery, and QR scan webhooks. The Free plan does not include webhook support. Verify current plan features at thanks.io/pricing.

Question 6

Can I use webhooks with Thanks.io's MCP server or AI agents?

Accepted Answer

Yes. Thanks.io's MCP server (docs.thanks.io/mcp) gives AI coding assistants full access to the API and webhook documentation, making it straightforward to build AI workflows that send physical mail and react to delivery or QR scan events. Thanks.io is the only direct mail platform with a native MCP server for AI agent integration.

Does Thanks.io Support Webhooks?

All questions answered

Related questions

Ready to send your first piece?