mailing_list, while the published schema uses mailing_list_id; both are accepted and forwarded unchanged. Bulk results may contain an error for an individual recipient.
Webhook destination operations manage Thanks.io’s outbound subscriptions; inbound webhook verification is not included.
Deleting a sub-account also deletes its image templates, message templates, and campaigns; its orders and mailing lists move to the main account.
Replaying an order creates and charges for a fresh mailing. Invalidating an unredeemed gift card is irreversible.
Send operations can create paid mailings. Use preview: true to request previews or the corresponding estimate endpoint to price a mailing before submitting. Email-to-address and radius lookup may incur additional charges.
imageBuilder.create returns the PNG as { contentType, base64 }; it does not place an order.
What you get:
- 52 typed API operations
Setup
1
Install
2
Add the plugin
corsair.ts
multiTenancy: true, scope calls with corsair.withTenant(id). See Quick start for KEK + Hub keys, and Multi-tenancy for account isolation.3
Choose authentication
- API Key (Recommended)
Store the Thanks.io API key before the first call: More: API Key
pnpm corsair setup --plugin=thanksio --tenant=acme api_key=<your-key> (leave out --tenant without multiTenancy), or pass it as key in the plugin options. With Hub, each tenant enters their own key on the connect page. See API key auth.4
Connect a tenant
Mint a connect link and send the tenant to it. Hub hosts the page and delivers the result to your app — see Connect / OAuth.
Example API calls
creatives.get
recipients.create
What’s next
API reference
Every
thanksio.api.* operation with input and output types.Connect / OAuth
createLink, Hub delivery, and tenant connect flows.
Use with agents
Expose this plugin’s operations as MCP tools.