Question 1

What can I do with the Thanks.io API?

Accepted Answer

The Thanks.io REST API (v2) lets you send any mailer type programmatically, manage mailing lists and recipients, create and update templates, configure and receive webhooks, verify addresses, and trigger or control all five campaign types. Every dashboard action is API-reproducible and logged in the Audit Log.

Question 2

How do I authenticate API requests?

Accepted Answer

Thanks.io supports two authentication methods: Personal access tokens (for single-account scripts and integrations — pass the token as a Bearer token in the Authorization header) and OAuth 2.0 (for multi-tenant applications that act on behalf of multiple Thanks.io accounts). Both methods use the same Bearer token header format.

Question 3

Is there a sandbox or test mode?

Accepted Answer

Yes. API Testing Mode lets you submit orders without generating real mail or charges. Enable it in Account Settings → API Access → API Settings → Test Mode. Remember to disable Test Mode before going live — orders placed in test mode are never physically mailed.

Question 4

Where can I find the Thanks.io API documentation?

Accepted Answer

Full documentation is at docs.thanks.io. A machine-readable OpenAPI spec is available at thanks.io/openapi.json. Thanks.io also provides an MCP server at docs.thanks.io/mcp, which gives AI coding assistants (Claude, Copilot, Cursor, etc.) structured, queryable access to the API docs and integration guides — making Thanks.io the only direct mail platform with native AI agent support built in.

Question 5

Does the API support webhooks?

Accepted Answer

Yes. Thanks.io webhooks fire on: Order Status Change, Order Item Status Change, Order Item Delivered, and QR Code Scans. Webhooks are delivered at-least-once — design your consumer to be idempotent and deduplicate on event ID. You can test webhooks directly from the dashboard webhook configuration screen.

Question 6

Which plan is required for API access?

Accepted Answer

API access requires the Business or Professional plan. The Free plan does not include API access. Business ($49/month) includes REST API access, webhooks, and Zapier/Make integrations. Professional ($199/month) includes all API features plus lowest per-piece rates and dedicated support.

Does Thanks.io Have an API?

All questions answered

Related questions

Ready to send your first piece?