# Thanks.io

thanks.io is a direct mail automation platform that enables users to send personalized postcards, letters, and notecards with handwritten fonts.

- **Category:** marketing automation
- **Auth:** API_KEY
- **Tools:** 33
- **Triggers:** 0
- **Slug:** `THANKS_IO`
- **Version:** 20260211_00

## Tools

### Add Recipient to Mailing List

**Slug:** `THANKS_IO_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

**Slug:** `THANKS_IO_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

**Slug:** `THANKS_IO_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

**Slug:** `THANKS_IO_DELETE_RECIPIENT_FROM_MAILING_LIST`

Tool to remove a recipient from a mailing list. Use after confirming the recipient's ID.

### Delete Sub-Account

**Slug:** `THANKS_IO_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

**Slug:** `THANKS_IO_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

**Slug:** `THANKS_IO_LIST_HANDWRITING_STYLES`

Tool to retrieve available handwriting styles. Use when selecting a style for handwritten personalization.

### List Image Templates

**Slug:** `THANKS_IO_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

**Slug:** `THANKS_IO_LIST_MAILING_LISTS`

Tool to list all mailing lists. Use when you need to fetch existing lists before managing recipients.

### List Message Templates

**Slug:** `THANKS_IO_LIST_MESSAGE_TEMPLATES`

Tool to list available message templates. Use when selecting a template for a mailing.

### Buy Radius Search Mailing List

**Slug:** `THANKS_IO_MAILING_LISTS_BUY_RADIUS_SEARCH`

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

**Slug:** `THANKS_IO_ORDER_PREVIEW_LETTER`

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

**Slug:** `THANKS_IO_ORDER_PREVIEW_NOTECARD`

Tool to preview a notecard send. Use when you need front and back images before placing an actual notecard order.

### Preview Postcard

**Slug:** `THANKS_IO_ORDER_PREVIEW_POSTCARD`

Tool to preview a postcard send. Use when you need front and back images before placing an order.

### Preview Windowless Letter

**Slug:** `THANKS_IO_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

**Slug:** `THANKS_IO_ORDERS_LIST`

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

**Slug:** `THANKS_IO_ORDERS_SEARCH_BY_ADDRESS`

Tool to search orders by recipient street address. Use when you need to find all orders sent to a specific street address.

### Search Orders by Recipient Full Name

**Slug:** `THANKS_IO_ORDERS_SEARCH_BY_NAME`

Tool to search orders by recipient full name. Searches through recent orders to find recipients matching the given name in the errors or returned items. Note: The Thanks.io API does not have a direct search endpoint, so this action fetches recent orders and searches for matching names in failed/returned items.

### Order Summary Statistics

**Slug:** `THANKS_IO_ORDERS_STATS`

Tool to retrieve order summary statistics. Use when analyzing order volume and value filtered by type, status, or date range. Aggregates statistics from recent orders.

### Proof Postcard

**Slug:** `THANKS_IO_PROOF_POSTCARD`

Tool to generate a proof/preview of a postcard's front and back. Use when you need to see how the postcard will look before sending it. Returns preview image URLs.

### Create Multiple Recipients

**Slug:** `THANKS_IO_RECIPIENTS_CREATE_MULTI`

Tool to create multiple recipients at once in a mailing list. Use when batching recipient additions for efficiency.

### Delete Recipient by Address

**Slug:** `THANKS_IO_RECIPIENTS_DELETE_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

**Slug:** `THANKS_IO_RECIPIENTS_GET_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

**Slug:** `THANKS_IO_RECIPIENTS_SEARCH_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

**Slug:** `THANKS_IO_RECIPIENTS_UPDATE`

Tool to update existing recipient details by recipient ID. Use when modifying recipient data after confirming the recipient exists.

### Send Postcard

**Slug:** `THANKS_IO_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

**Slug:** `THANKS_IO_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

**Slug:** `THANKS_IO_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

**Slug:** `THANKS_IO_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

**Slug:** `THANKS_IO_SUB_ACCOUNTS_CREATE`

Tool to create a new sub-account. Use when you need to manage separate profiles with distinct return addresses and settings.

### List Sub Accounts

**Slug:** `THANKS_IO_SUB_ACCOUNTS_LIST`

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

**Slug:** `THANKS_IO_SUB_ACCOUNTS_SHOW`

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

**Slug:** `THANKS_IO_SUB_ACCOUNTS_UPDATE`

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.
