> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Thanks.io

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

![Thanks.io logo](https://mintcdn.com/composio-preview/IA0_SoMcsWt17HEC/images/toolkits/thanks_io.svg?fit=max\&auto=format\&n=IA0_SoMcsWt17HEC\&q=85\&s=844cba7c0be8da51c876e27ffdc39bda)

* **Category:** marketing automation
* **Auth:** API\_KEY
* **Composio-managed OAuth available?** N/A
* **Tools:** 29
* **Triggers:** 0
* **Slug:** `THANKS_IO`
* **Version:** 20261101\_00

## Tools

> [accordion] 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
>
> **city** `string` *required*
>
> City of the recipient's address
>
> **name** `string` *required*
>
> Full name of the recipient
>
> **email** `string`
>
> Recipient's email address
>
> **phone** `string`
>
> Recipient's phone number
>
> **address** `string` *required*
>
> Primary street address of the recipient
>
> **country** `string` *required*
>
> Country code of the recipient's address (ISO 3166-1 alpha-2)
>
> **address2** `string`
>
> Additional address information (e.g., apartment or suite number)
>
> **province** `string` *required*
>
> State or province of the recipient's address
>
> **postal\_code** `string` *required*
>
> Postal or ZIP code of the recipient's address
>
> **mailing\_list** `string` *required*
>
> ID of the mailing list to which the recipient will be added
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] 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
>
> **name** `string` *required*
>
> Name of the new mailing list
>
> **description** `string` *required*
>
> Brief description of the mailing list (required by API)
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] 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
>
> **list\_id** `string` *required*
>
> The UUID of the mailing list to delete.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] 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
>
> **recipient\_id** `string` *required*
>
> Unique identifier of the recipient to remove
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] 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
>
> **id** `integer` *required*
>
> The unique ID of the sub-account to delete.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Execute Stored Send
>
> **Slug:** `THANKS_IO_EXECUTE_STORED_SEND`
>
> Execute a previously created stored send to trigger delivery. The tool returns an empty response for HTTP statuses below 400.
>
> #### Input Parameters
>
> **uuid** `string` *required*
>
> UUID of the stored send resource to execute
>
> **send\_type** `string ("postcard" | "letter" | "windowlessletter" | "notecard" | "giftcard")` *required*
>
> Type of stored send to execute
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Handwriting Styles
>
> **Slug:** `THANKS_IO_LIST_HANDWRITING_STYLES`
>
> Tool to retrieve available handwriting styles. Use when selecting a style for handwritten personalization.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] 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.
>
> #### Input Parameters
>
> **page** `integer`
>
> Page number to retrieve (1-indexed). Defaults to 1.
>
> **items\_per\_page** `integer`
>
> Number of items to return per page. Default is 25.
>
> **sub\_account\_id** `integer`
>
> Filter results by Sub Account ID.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Mailing Lists
>
> **Slug:** `THANKS_IO_LIST_MAILING_LISTS`
>
> List mailing lists for the account. The tool returns the lists in the API response, which may be a single page.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] 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
>
> **items\_per\_page** `integer`
>
> Number of items to return per page. Default is 25.
>
> **sub\_account\_id** `integer`
>
> Filter results by Sub Account ID.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Buy Radius Search Mailing List
>
> **Slug:** `THANKS_IO_MAILING_LISTS_BUY_RADIUS_SEARCH`
>
> Buy a targeted mailing list around a specified address or append results to an existing list, using a requested count of nearest records.
>
> #### Input Parameters
>
> **address** `string` *required*
>
> Full address to use as the center of the radius search
>
> **append\_data** `boolean`
>
> Append phone and email to each record for an additional fee
>
> **postal\_code** `string` *required*
>
> Postal code for the search
>
> **record\_count** `integer` *required*
>
> 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")`
>
> Type of records to search for
>
> **include\_condos** `boolean`
>
> Include condos in search results
>
> **mailing\_list\_id** `integer`
>
> Optional ID of existing mailing list to append results to. If not provided, a new list will be created.
>
> **use\_property\_owner** `boolean`
>
> Use property owner's address when searching for commercial record types
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Preview letter send
>
> **Slug:** `THANKS_IO_ORDER_PREVIEW_LETTER`
>
> Request a letter send preview as PDF and return preview URLs. Set preview to true for a preview; false is also accepted and may place an order instead.
>
> #### Input Parameters
>
> **message** `string`
>
> Handwritten message content to appear on the letter cover page.
>
> **preview** `boolean` *required*
>
> Must be true to generate and return PDF preview URLs instead of placing an order.
>
> **recipients** `array`
>
> List of recipients for the letter. Required if mailing\_lists not provided.
>
> **return\_city** `string`
>
> City for the return address.
>
> **return\_name** `string`
>
> Name to print on the return address block.
>
> **return\_state** `string`
>
> State or province for the return address.
>
> **mailing\_lists** `array`
>
> IDs of mailing lists to preview. Required if recipients not provided.
>
> **return\_address** `string`
>
> Street address line 1 for the return address.
>
> **return\_address2** `string`
>
> Street address line 2 for the return address.
>
> **additional\_pages** `string`
>
> URL to a PDF file containing additional pages to include in the letter. Up to 10 pages allowed, printed double-sided.
>
> **handwriting\_style** `integer`
>
> ID of the handwriting style to use for the letter body.
>
> **return\_postal\_code** `string`
>
> Postal or ZIP code for the return address.
>
> **custom\_background\_image** `string`
>
> URL to the background image for the letter (JPEG/PNG).
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] 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
>
> **message** `string` *required*
>
> Handwritten message content to place inside the notecard.
>
> **preview** `boolean` *required*
>
> Must be true to return preview images instead of sending.
>
> **recipients** `array` *required*
>
> List of recipient objects for the notecard preview.
>
> **image\_template** `integer` *required*
>
> ID of a pre-saved notecard image template.
>
> **handwriting\_style** `integer` *required*
>
> ID of the handwriting style to use.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] 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
>
> **message** `string`
>
> Handwritten message content. Required if 'message\_template' not set
>
> **preview** `boolean` *required*
>
> Must be true to return a PDF preview of the letter send
>
> **recipients** `array` *required*
>
> List of recipients for the preview send
>
> **front\_image\_url** `string` *required*
>
> URL to the cover image for the windowless letter
>
> **message\_template** `string`
>
> ID of a stored message template. Required if 'message' not set
>
> **handwriting\_color** `string`
>
> Ink color for handwriting (e.g., 'blue','black', or hex code)
>
> **handwriting\_style** `string`
>
> ID of handwriting style to use
>
> **additional\_pages\_url** `string`
>
> URL to a single-page PDF to print on back of cover image
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] 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
>
> **items\_per\_page** `integer`
>
> Number of items to return per page (default: 25).
>
> **sub\_account\_id** `integer`
>
> Filter orders by this sub-account ID.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Search Orders by Recipient Street Address
>
> **Slug:** `THANKS_IO_ORDERS_SEARCH_BY_ADDRESS`
>
> Search orders by recipient street address, returning a page of matched order items and orders.
>
> #### Input Parameters
>
> **page** `integer`
>
> Page number for paginated results, default is 1.
>
> **address** `string` *required*
>
> Street address to search orders by.
>
> **per\_page** `integer`
>
> Number of results per page, between 1 and 100, default is 50.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Multiple Recipients
>
> **Slug:** `THANKS_IO_RECIPIENTS_CREATE_MULTI`
>
> Create multiple recipients in a mailing list through individual requests. If a request fails, earlier recipients may already have been created.
>
> #### Input Parameters
>
> **list\_id** `string` *required*
>
> ID of the mailing list to which recipients will be added
>
> **recipients** `array` *required*
>
> List of recipients to create at once in the mailing list
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Recipient by Address
>
> **Slug:** `THANKS_IO_RECIPIENTS_DELETE_BY_ADDRESS`
>
> Delete recipients matching an exact street address and postal code across retrieved mailing lists, without requiring their IDs. Multiple matches may be deleted; list retrieval and individual deletion failures can leave matches undeleted.
>
> #### Input Parameters
>
> **address** `string` *required*
>
> Full street address of the recipient
>
> **postal\_code** `string` *required*
>
> Postal or ZIP code of the recipient's address
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] 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
>
> **recipient\_id** `string` *required*
>
> Unique identifier of the recipient to retrieve
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Search Recipients by Email
>
> **Slug:** `THANKS_IO_RECIPIENTS_SEARCH_BY_EMAIL`
>
> Search recipients by email in specified mailing lists. Returns a page of matching recipients with pagination metadata.
>
> #### Input Parameters
>
> **email** `string` *required*
>
> Email address to search for.
>
> **limit** `integer`
>
> Maximum number of recipients to return; defaults to server limit if unset.
>
> **mailing\_list\_ids** `array` *required*
>
> Array of mailing list IDs to search in.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] 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
>
> **city** `string`
>
> City of the recipient's address
>
> **name** `string`
>
> Full name of the recipient
>
> **email** `string`
>
> Email address of the recipient
>
> **phone** `string`
>
> Phone number of the recipient
>
> **address** `string`
>
> Primary street address of the recipient
>
> **country** `string`
>
> Country code of the recipient's address (ISO 3166-1 alpha-2)
>
> **custom1** `string`
>
> Custom field 1 for the recipient
>
> **custom2** `string`
>
> Custom field 2 for the recipient
>
> **custom3** `string`
>
> Custom field 3 for the recipient
>
> **custom4** `string`
>
> Custom field 4 for the recipient
>
> **address2** `string`
>
> Additional address information (e.g., apartment or suite number)
>
> **province** `string`
>
> State or province of the recipient's address
>
> **postal\_code** `string`
>
> Postal or ZIP code of the recipient's address
>
> **recipient\_id** `string` *required*
>
> Unique identifier of the recipient to update
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Send Postcard
>
> **Slug:** `THANKS_IO_SEND_POSTCARD`
>
> Send a customized physical postcard with a chosen image and handwritten message, or request a preview without sending.
>
> #### Input Parameters
>
> **size** `string ("4x6" | "6x9" | "6x11")`
>
> Postcard size; defaults to '4x6'
>
> **message** `string`
>
> Handwritten message content (required if 'message\_template' is not provided)
>
> **preview** `boolean`
>
> If true, returns a preview of the postcard without sending. Useful for validation.
>
> **qrcode\_url** `string`
>
> URL to auto-generate a QR code on the back of the postcard
>
> **recipients** `array`
>
> Explicit recipient objects
>
> **return\_city** `string`
>
> City for the return address
>
> **return\_name** `string`
>
> Name for the return address
>
> **sub\_account** `string`
>
> ID of the sub-account to bill this order
>
> **return\_state** `string`
>
> State for the return address
>
> **mailing\_lists** `array`
>
> List of mailing-list IDs to send to
>
> **radius\_search** `object`
>
> Parameters for a radius-based address search.
>
> **image\_template** `string`
>
> ID of a pre-saved front-image template (required if 'front\_image\_url' is not provided)
>
> **return\_address** `string`
>
> Street address for the return address
>
> **front\_image\_url** `string`
>
> URL to the image for the front of the postcard (required if 'image\_template' is not provided)
>
> **return\_address2** `string`
>
> Additional street address information
>
> **email\_additional** `string`
>
> Email address to receive order alerts (e.g., QR scan notifications)
>
> **message\_template** `string`
>
> ID of a pre-saved message template (required if 'message' is not provided)
>
> **handwriting\_color** `string`
>
> Handwriting ink color (e.g., 'blue', 'black', '#4287f5')
>
> **handwriting\_style** `string`
>
> ID of the handwriting style to use
>
> **return\_postal\_code** `string`
>
> Postal code for the return address
>
> **send\_standard\_mail** `boolean`
>
> If true, sends as USPS Standard Mail postage class
>
> **use\_custom\_background** `boolean`
>
> Whether to use a custom background image
>
> **custom\_background\_image** `string`
>
> URL to a custom background image (1875×1275 px)
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Stored Send Notecard
>
> **Slug:** `THANKS_IO_STORED_SEND_NOTECARD`
>
> Create a stored send for a personalized notecard and return a URL to execute it later.
>
> #### Input Parameters
>
> **message** `string` *required*
>
> Handwritten message content for the notecard
>
> **qrcode\_url** `string`
>
> URL to generate a QR code inside the notecard
>
> **recipients** `array` *required*
>
> List of recipient mailing details
>
> **sub\_account** `string`
>
> ID of the sub-account to use for this order
>
> **front\_image\_url** `string` *required*
>
> URL to the image for the front of the notecard
>
> **email\_additional** `string`
>
> Email to send order alerts (e.g., QR scan notifications)
>
> **handwriting\_color** `string`
>
> Handwriting color name or hex code
>
> **handwriting\_style** `string`
>
> ID of the handwriting style to use
>
> **send\_standard\_mail** `boolean`
>
> Set to true to send via standard mail postage
>
> **use\_custom\_background** `boolean`
>
> Whether to use a custom background image
>
> **custom\_background\_image** `string`
>
> URL to custom background (1650×2475px required)
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Stored Send Postcard
>
> **Slug:** `THANKS_IO_STORED_SEND_POSTCARD`
>
> Create a stored send for a postcard and return a URL to finalize and send it later.
>
> #### Input Parameters
>
> **size** `string ("4x6" | "6x9" | "6x11")`
>
> Postcard size
>
> **message** `string`
>
> Handwritten message content
>
> **preview** `boolean`
>
> If true, return preview images instead of scheduling send
>
> **qrcode\_url** `string`
>
> URL to auto-generate a QR code on back
>
> **recipients** `array`
>
> List of recipients
>
> **mailing\_lists** `array`
>
> List of mailing list IDs
>
> **image\_template** `string`
>
> ID of front-image template
>
> **front\_image\_url** `string`
>
> URL to front image
>
> **message\_template** `string`
>
> ID of message template
>
> **handwriting\_color** `string`
>
> Handwriting ink color
>
> **handwriting\_style** `string`
>
> ID of handwriting style to apply
>
> **custom\_background\_image** `string`
>
> URL to custom background image
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] 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
>
> **message** `string` *required*
>
> Handwritten message content
>
> **recipients** `array` *required*
>
> List of recipients to schedule the stored send for
>
> **front\_image\_url** `string` *required*
>
> URL to the cover image for the windowless letter
>
> **handwriting\_style** `integer` *required*
>
> ID of the handwriting style to use
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] 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
>
> **title** `string` *required*
>
> Name of the sub-account
>
> **return\_city** `string`
>
> City for the return address (optional)
>
> **return\_name** `string`
>
> Name for the return address (optional)
>
> **return\_state** `string`
>
> State for the return address (2-letter code, optional)
>
> **return\_address** `string`
>
> Primary return street address (optional)
>
> **return\_address2** `string`
>
> Secondary return street address (optional)
>
> **return\_postal\_code** `string`
>
> Postal code for the return address (optional)
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Sub Accounts
>
> **Slug:** `THANKS_IO_SUB_ACCOUNTS_LIST`
>
> List up to five sub-accounts for selecting a sub-account context. The result contains only the first five entries returned by the API.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Sub Account Details
>
> **Slug:** `THANKS_IO_SUB_ACCOUNTS_SHOW`
>
> Retrieve details for a specific sub-account by ID, including its name, return address, default envelope and timestamps.
>
> #### Input Parameters
>
> **sub\_account\_id** `string` *required*
>
> Unique identifier of the sub-account to retrieve
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] 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
>
> **title** `string`
>
> New name for the sub-account.
>
> **return\_city** `string`
>
> New city for the return address.
>
> **return\_name** `string`
>
> New return recipient name.
>
> **return\_state** `string`
>
> New state/province for the return address (2-letter code).
>
> **return\_address** `string`
>
> New primary return street address.
>
> **sub\_account\_id** `string` *required*
>
> Unique identifier of the sub-account to update.
>
> **return\_address2** `string`
>
> New secondary return address (optional).
>
> **return\_postal\_code** `string`
>
> New postal code for the return address.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not
