Connect Thanks.io to your AI agent
thanks.io is a direct mail automation platform that enables users to send personalized postcards, letters, and notecards with handwritten fonts.
We set up the connection using your own Thanks.io account, with keys you control, and keep it running. Your agent picks it up and starts doing the work.
Actions
What your agent can do in Thanks.io
Each one is a real action the agent can take on its own, the same things a person clicking around Thanks.io could do. Read-only by default; write actions are confirmed against your policy.
- Add Recipient to Mailing List Tool to add a new recipient to a mailing list. Use after confirming recipient and list IDs.
- Create Mailing List Tool to create a new mailing list. Use when you need to group contacts under a fresh list before adding recipients.
- Delete Mailing List Tool to delete a mailing list. Use when you need to remove an entire mailing list by its ID. Confirm the list ID before calling. Example: "Delete the mailing list with ID 123e4567-e89b-12d3-a456-426614174000".
- Delete Recipient from Mailing List Tool to remove a recipient from a mailing list. Use after confirming the recipient's ID.
- Delete sub account Tool to delete a specific sub-account by ID. Use when you need to remove an existing sub-account. Confirm the ID before calling.
- Execute Stored Send Tool to execute a previously created stored send. Use after creating a stored send to trigger delivery. The response body is empty; success is indicated by a 200 or 204 status.
- List Handwriting Styles Tool to retrieve available handwriting styles. Use when selecting a style for handwritten personalization.
- List Image Templates Tool to retrieve a list of available image templates. Use when you need to browse or select a template for mailings.
- List Mailing Lists Tool to list all mailing lists. Use when you need to fetch existing lists before managing recipients.
- List Message Templates Tool to list available message templates. Use when selecting a template for a mailing.
- Buy Radius Search Mailing List Tool to buy or append a radius search mailing list based on address and radius. Use when you need targeted mailing lists around a specified address.
- Preview letter send Tool to preview a letter send as PDF. Use when you need to confirm letter content before placing the final order. Returns PDF preview URLs.
- Preview Notecard Tool to preview a notecard send. Use when you need front and back images before placing an actual notecard order.
- Preview Windowless Letter Tool to preview a windowless letter send. Use when you need a PDF preview of the cover-only letter before placing an order.
- List Orders Tool to list recent orders. Use after placing orders to fetch the latest history, optionally filtering by sub-account or limiting the result count.
- Search Orders by Recipient Street Address Tool to search orders by recipient street address. Use when you need to find all orders sent to a specific street address.
- Create Multiple Recipients Tool to create multiple recipients at once in a mailing list. Use when batching recipient additions for efficiency.
- Delete Recipient by Address Tool to delete a recipient by address and postal code. Use when you need to remove a recipient without their ID.
- Get Recipient Details Tool to get details for a specific recipient by ID. Use to verify a recipient’s full address and custom fields.
- Search Recipients by Email Tool to search recipients by email across mailing lists. Use when you need to find all recipients matching an email in specific lists. Example: "Find recipients with email test@test.com in lists [1,2,3]."
- Update Recipient Tool to update existing recipient details by recipient ID. Use when modifying recipient data after confirming the recipient exists.
- Send Postcard Tool to send a customized postcard. Use when you need to dispatch a physical postcard with a chosen image and handwritten message.
- Stored Send Notecard Tool to create a stored send for a notecard. Use when you need to schedule mailing of a personalized notecard at a later time after preparing payload.
- Stored Send Postcard Tool to create a stored send for a postcard. Use when you need to prepare and schedule postcard orders for later execution; returns a URL to finalize and send.
- Stored Send Windowless Letter Tool to create a stored send for a windowless letter. Use when you need to prepare a letter order for later execution.
- Create sub account Tool to create a new sub-account. Use when you need to manage separate profiles with distinct return addresses and settings.
- List Sub Accounts Tool to list all available sub-accounts. Use when you need to select a sub-account for operations requiring a sub-account context.
- Get Sub Account Details Tool to retrieve details for a specific sub-account by ID. Use when you need full configuration of a sub-account before performing sub-account scoped operations.
- Update sub account Tool to update details for a specific sub-account. Use when modifying title or return address details of a sub-account. Confirm sub-account ID before calling.
Setup
How we connect it
- 1
Connect your account
You create a key in Thanks.io, a key you create and control, and paste it in once. It lives in a secrets store on your server, not with us.
- 2
Set the guardrails
Read-only by default. You choose which write actions the agent may take, and anything outside that policy gets confirmed with you first.
- 3
We keep it running
Health checks on every connection, updates handled for you, and we watch the first week of activity to make sure the work lands.
FAQ
Thanks.io questions, answered.
With a key you create and control. You paste it in once, it is stored in a secrets store on your server, permissions are scoped to the minimum the agent needs, and you can revoke it at any time.
The actions Thanks.io's API allows, the same things a person clicking around the app could do. Connections start read-only by default; write actions are confirmed against the policy you set before the agent takes them.
Connections are priced per tool on top of the base plan. Some are included, some are premium. See pricing for how connection charges work.
Standard tools are ready inside 7 business days of the setup call. We test the connection end to end, walk you through how the agent uses it, and watch the first week of activity.
Ready to put Thanks.io to work?
Tell us what your team runs on. We set up the connection, secure it, and your agent takes it from there.
All product names, logos, and brands are property of their respective owners; used for identification only. ZeroToClaw is not affiliated with or endorsed by Thanks.io.