# 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
- **Composio Managed App Available?** N/A
- **Tools:** 31
- **Triggers:** 0
- **Slug:** `THANKS_IO`
- **Version:** 20260312_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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `city` | string | Yes | City of the recipient's address |
| `name` | string | Yes | Full name of the recipient |
| `email` | string | No | Recipient's email address |
| `phone` | string | No | Recipient's phone number |
| `address` | string | Yes | Primary street address of the recipient |
| `country` | string | Yes | Country code of the recipient's address (ISO 3166-1 alpha-2) |
| `address2` | string | No | Additional address information (e.g., apartment or suite number) |
| `province` | string | Yes | State or province of the recipient's address |
| `postal_code` | string | Yes | Postal or ZIP code of the recipient's address |
| `mailing_list` | string | Yes | ID of the mailing list to which the recipient will be added |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | Yes | Name of the new mailing list |
| `description` | string | Yes | Brief description of the mailing list (required by API) |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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".

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `list_id` | string | Yes | The UUID of the mailing list to delete. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `recipient_id` | string | Yes | Unique identifier of the recipient to remove |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | integer | Yes | The unique ID of the sub-account to delete. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `uuid` | string | Yes | UUID of the stored send resource to execute |
| `send_type` | string ("postcard" | "letter" | "windowlessletter" | "notecard" | "giftcard") | Yes | Type of stored send to execute |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Handwriting Styles

**Slug:** `THANKS_IO_LIST_HANDWRITING_STYLES`

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

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Message Templates

**Slug:** `THANKS_IO_LIST_MESSAGE_TEMPLATES`

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

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `items_per_page` | integer | No | Number of items to return per page. Default is 25. |
| `sub_account_id` | integer | No | Filter results by Sub Account ID. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `address` | string | Yes | Full address to use as the center of the radius search |
| `append_data` | boolean | No | Append phone and email to each record for an additional fee |
| `postal_code` | string | Yes | Postal code for the search |
| `record_count` | integer | Yes | Number of nearest neighbors to search for (1-10000) |
| `record_types` | string ("all" | "likelytomove" | "likelytorefi" | "absenteeowner" | "highnetworth" | "majorityhomeequity" | "homefreeclear" | "underwater" | "kidsinhousehold" | "newhomeowner" | "firsttimehomebuyer" | "renters" | "retiring" | "retired" | "pool" | "onlybusinesses" | "newbusiness") | No | Type of records to search for |
| `include_condos` | boolean | No | Include condos in search results |
| `mailing_list_id` | integer | No | Optional ID of existing mailing list to append results to. If not provided, a new list will be created. |
| `use_property_owner` | boolean | No | Use property owner's address when searching for commercial record types |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `message` | string | No | Handwritten message content to appear on the letter cover page. |
| `preview` | boolean | Yes | Must be true to generate and return PDF preview URLs instead of placing an order. |
| `recipients` | array | No | List of recipients for the letter. Required if mailing_lists not provided. |
| `return_city` | string | No | City for the return address. |
| `return_name` | string | No | Name to print on the return address block. |
| `return_state` | string | No | State or province for the return address. |
| `mailing_lists` | array | No | IDs of mailing lists to preview. Required if recipients not provided. |
| `return_address` | string | No | Street address line 1 for the return address. |
| `return_address2` | string | No | Street address line 2 for the return address. |
| `additional_pages` | string | No | URL to a PDF file containing additional pages to include in the letter. Up to 10 pages allowed, printed double-sided. |
| `handwriting_style` | integer | No | ID of the handwriting style to use for the letter body. |
| `return_postal_code` | string | No | Postal or ZIP code for the return address. |
| `custom_background_image` | string | No | URL to the background image for the letter (JPEG/PNG). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `message` | string | Yes | Handwritten message content to place inside the notecard. |
| `preview` | boolean | Yes | Must be true to return preview images instead of sending. |
| `recipients` | array | Yes | List of recipient objects for the notecard preview. |
| `image_template` | integer | Yes | ID of a pre-saved notecard image template. |
| `handwriting_style` | integer | Yes | ID of the handwriting style to use. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `message` | string | No | Handwritten message content. Required if 'message_template' not set |
| `preview` | boolean | Yes | Must be true to return a PDF preview of the letter send |
| `recipients` | array | Yes | List of recipients for the preview send |
| `front_image_url` | string | Yes | URL to the cover image for the windowless letter |
| `message_template` | string | No | ID of a stored message template. Required if 'message' not set |
| `handwriting_color` | string | No | Ink color for handwriting (e.g., 'blue','black', or hex code) |
| `handwriting_style` | string | No | ID of handwriting style to use |
| `additional_pages_url` | string | No | URL to a single-page PDF to print on back of cover image |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `items_per_page` | integer | No | Number of items to return per page (default: 25). |
| `sub_account_id` | integer | No | Filter orders by this sub-account ID. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number for paginated results, default is 1. |
| `address` | string | Yes | Street address to search orders by. |
| `per_page` | integer | No | Number of results per page, between 1 and 100, default is 50. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `list_id` | string | Yes | ID of the mailing list to which recipients will be added |
| `recipients` | array | Yes | List of recipients to create at once in the mailing list |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `address` | string | Yes | Full street address of the recipient |
| `postal_code` | string | Yes | Postal or ZIP code of the recipient's address |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `recipient_id` | string | Yes | Unique identifier of the recipient to retrieve |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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]."

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `email` | string | Yes | Email address to search for. |
| `limit` | integer | No | Maximum number of recipients to return; defaults to server limit if unset. |
| `mailing_list_ids` | array | Yes | Array of mailing list IDs to search in. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `city` | string | No | City of the recipient's address |
| `name` | string | No | Full name of the recipient |
| `email` | string | No | Email address of the recipient |
| `phone` | string | No | Phone number of the recipient |
| `address` | string | No | Primary street address of the recipient |
| `country` | string | No | Country code of the recipient's address (ISO 3166-1 alpha-2) |
| `custom1` | string | No | Custom field 1 for the recipient |
| `custom2` | string | No | Custom field 2 for the recipient |
| `custom3` | string | No | Custom field 3 for the recipient |
| `custom4` | string | No | Custom field 4 for the recipient |
| `address2` | string | No | Additional address information (e.g., apartment or suite number) |
| `province` | string | No | State or province of the recipient's address |
| `postal_code` | string | No | Postal or ZIP code of the recipient's address |
| `recipient_id` | string | Yes | Unique identifier of the recipient to update |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `size` | string ("4x6" | "6x9" | "6x11") | No | Postcard size; defaults to '4x6' |
| `message` | string | No | Handwritten message content (required if 'message_template' is not provided) |
| `preview` | boolean | No | If true, returns a preview of the postcard without sending. Useful for validation. |
| `qrcode_url` | string | No | URL to auto-generate a QR code on the back of the postcard |
| `recipients` | array | No | Explicit recipient objects |
| `return_city` | string | No | City for the return address |
| `return_name` | string | No | Name for the return address |
| `sub_account` | string | No | ID of the sub-account to bill this order |
| `return_state` | string | No | State for the return address |
| `mailing_lists` | array | No | List of mailing-list IDs to send to |
| `radius_search` | object | No | Parameters for a radius-based address search. |
| `image_template` | string | No | ID of a pre-saved front-image template (required if 'front_image_url' is not provided) |
| `return_address` | string | No | Street address for the return address |
| `front_image_url` | string | No | URL to the image for the front of the postcard (required if 'image_template' is not provided) |
| `return_address2` | string | No | Additional street address information |
| `email_additional` | string | No | Email address to receive order alerts (e.g., QR scan notifications) |
| `message_template` | string | No | ID of a pre-saved message template (required if 'message' is not provided) |
| `handwriting_color` | string | No | Handwriting ink color (e.g., 'blue', 'black', '#4287f5') |
| `handwriting_style` | string | No | ID of the handwriting style to use |
| `return_postal_code` | string | No | Postal code for the return address |
| `send_standard_mail` | boolean | No | If true, sends as USPS Standard Mail postage class |
| `use_custom_background` | boolean | No | Whether to use a custom background image |
| `custom_background_image` | string | No | URL to a custom background image (1875×1275 px) |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `message` | string | Yes | Handwritten message content for the notecard |
| `qrcode_url` | string | No | URL to generate a QR code inside the notecard |
| `recipients` | array | Yes | List of recipient mailing details |
| `sub_account` | string | No | ID of the sub-account to use for this order |
| `front_image_url` | string | Yes | URL to the image for the front of the notecard |
| `email_additional` | string | No | Email to send order alerts (e.g., QR scan notifications) |
| `handwriting_color` | string | No | Handwriting color name or hex code |
| `handwriting_style` | string | No | ID of the handwriting style to use |
| `send_standard_mail` | boolean | No | Set to true to send via standard mail postage |
| `use_custom_background` | boolean | No | Whether to use a custom background image |
| `custom_background_image` | string | No | URL to custom background (1650×2475px required) |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `size` | string ("4x6" | "6x9" | "6x11") | No | Postcard size |
| `message` | string | No | Handwritten message content |
| `preview` | boolean | No | If true, return preview images instead of scheduling send |
| `qrcode_url` | string | No | URL to auto-generate a QR code on back |
| `recipients` | array | No | List of recipients |
| `mailing_lists` | array | No | List of mailing list IDs |
| `image_template` | string | No | ID of front-image template |
| `front_image_url` | string | No | URL to front image |
| `message_template` | string | No | ID of message template |
| `handwriting_color` | string | No | Handwriting ink color |
| `handwriting_style` | string | No | ID of handwriting style to apply |
| `custom_background_image` | string | No | URL to custom background image |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `message` | string | Yes | Handwritten message content |
| `recipients` | array | Yes | List of recipients to schedule the stored send for |
| `front_image_url` | string | Yes | URL to the cover image for the windowless letter |
| `handwriting_style` | integer | Yes | ID of the handwriting style to use |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `title` | string | Yes | Name of the sub-account |
| `return_city` | string | No | City for the return address (optional) |
| `return_name` | string | No | Name for the return address (optional) |
| `return_state` | string | No | State for the return address (2-letter code, optional) |
| `return_address` | string | No | Primary return street address (optional) |
| `return_address2` | string | No | Secondary return street address (optional) |
| `return_postal_code` | string | No | Postal code for the return address (optional) |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `sub_account_id` | string | Yes | Unique identifier of the sub-account to retrieve |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `title` | string | No | New name for the sub-account. |
| `return_city` | string | No | New city for the return address. |
| `return_name` | string | No | New return recipient name. |
| `return_state` | string | No | New state/province for the return address (2-letter code). |
| `return_address` | string | No | New primary return street address. |
| `sub_account_id` | string | Yes | Unique identifier of the sub-account to update. |
| `return_address2` | string | No | New secondary return address (optional). |
| `return_postal_code` | string | No | New postal code for the return address. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |