Thanks.io integration: operations for AI agents
Thanks.io connects to Type.com as an integration. This page lists the 52 operations documented for Claude and Codex in Type.com: 19 read, 22 write, 11 destructive.
About Thanks.io
thanks.io is a direct mail automation platform that enables users to send personalized postcards, letters, and notecards with handwritten fonts.
Categories: Marketing & Social
How to connect Thanks.io to Type.com
- Access
- Organization connection: one shared account for the workspace.
To add the connection, follow the steps in Space connections.
Documented operations
52 operations. Your connection's permissions determine which operations are available. API references describe the vendor surface; they do not expand your connection's credentials or access.
52 operations listed.
Recipients
- Read
Get Recipient
Get a recipient by ID.
- Write
Create Recipient
Add a recipient. If you do not provide a valid mailing address but do provide a valid email address, thanks.io can attempt to look up a street address for an additional fee.
- Write
Create Multiple Recipients
Add multiple recipients at once using a JSON array of recipient objects. If a recipient does not include a valid mailing address but does include a valid email address, thanks.io can attempt to look up a street address for an additional fee.
- Destructive
Update Recipient
Update details of a specific recipient by ID. Leave out absenteeaddress to keep the current absentee address.
- Destructive
Delete Recipient
DELETE /recipients/{recipientId}
- Destructive
Delete Recipient By Address
Delete a recipient by using their address or their email address.
Mailing Lists
- Read
List All
List all available mailing lists. Returns a paginated list of mailing lists.
- Read
Get Details
Gets a mailing list by ID. Returns a single mailing list object.
- Read
List Recipients
Retrieve recipients for a specific mailing list.
- Write
Create Mailing List
If qrcodeurl is provided, it will be used as the default QR Code URL when placing orders with this mailing list.
- Write
Radius Search
This call will purchase a radius search mailing listing and add it to your account. Each record added to the mailing list costs $.05. You can specify the number of records to return (up to 2,500) and the address/postal code to center the search around.
- Write
Radius Search Count
This call reports how many records a radius search would find, without buying them. Nothing is charged, no mailing list is created, and the call can be repeated freely, so use it to preview a search before purchasing it with the Radius Search endpoint.
- Destructive
Delete Mailing List
DELETE /mailing-lists/{mailingListId}
Send Mailer
- Write
Send Postcard
Send a 4x6, 6x9, or 6x11 postcard.
- Write
Send Magnacard
Send a Magnacard.
- Write
Send Windowed Letter
Send a letter in a windowed envelope.
- Write
Send Windowless Letter
Send a letter in a windowless envelope.
- Write
Send Notecard
Send a folded 4.25x5.5 notecard in envelope.
- Write
Send Giftcard
Send a folded 4.25x5.5 giftcard in envelope.
Order Estimates
- Write
Estimate Postcard
Price a postcard order without placing it. Send the same request body you would send to Send Postcard: nothing is charged, nothing is printed or mailed, and no order is created.
- Write
Estimate Windowed Letter
Price a windowed letter order without placing it. Send the same request body you would send to Send Windowed Letter: nothing is charged, nothing is printed or mailed, and no order is created.
- Write
Estimate Windowless Letter
Price a windowless letter order without placing it. Send the same request body you would send to Send Windowless Letter: nothing is charged, nothing is printed or mailed, and no order is created.
- Write
Estimate Notecard
Price a notecard order without placing it. Send the same request body you would send to Send Notecard: nothing is charged, nothing is printed or mailed, and no order is created.
- Write
Estimate Magnacard
Price a magnacard order without placing it. Send the same request body you would send to Send Magnacard: nothing is charged, nothing is printed or mailed, and no order is created.
- Write
Estimate Giftcard
Price a giftcard order without placing it. Send the same request body you would send to Send Giftcard: nothing is charged, nothing is printed or mailed, and no order is created.
Dynamic Images
- Read
Create
Build image for the front of your postcard or notecard. Includes ability to set dynmiac fields and QR code. This does not create an order, it simply builds the image and returns a URL to the image. You can then use this image URL in your order creation request.
Handwriting Styles
- Read
List Styles
List Available Handwriting Styles
Giftcards
- Read
List Brands
List all available Giftcard brands.
- Read
List Brands Flat
List all available Giftcard brands as a flat list.
Sub Accounts
- Read
List All
List all available sub-accounts.
- Read
Get Details
Gets a sub-account by ID. Returns a single sub-account object. brandingfields is an object that contains branding information for the sub-account - it can only be set via the thanks.io dashboard
- Write
Create Sub Account
Create a new sub-account.
- Destructive
Update Sub Account
PUT /sub-accounts/{subAccountId}
- Destructive
Delete Sub Account. All sub account orders and mailing lists are moved to the main account.
Delete Sub Account. All sub account orders and mailing lists are moved to the main account. All image templates, message templates, and campaigns are deleted.
Image Templates
- Read
List All
List all available image templates.
Creatives Library
- Read
List All
List the creatives in your Creatives library, 24 per page: the default creative of each type first, then most recently updated. A creative pairs an image template with a message template; send one by passing its id as creativeid to any send or estimate endpoint.
- Read
Get
Get one creative from your Creatives library, with the image and message templates it pairs.
Message Templates
- Read
List All
List all available message templates.
- Read
Get Message Template
Fetch a single message template by ID.
- Write
Create Message Template
Create a message template for the authenticated user using the public v2 request shape.
- Write
Update Message Template
Update a message template using the public v2 request shape.
- Destructive
Delete Message Template
Delete a message template.
Webhooks
- Read
List Webhooks
Return a paginated list of configured webhooks. Webhooks are available on paid subscriptions only.
- Write
Create Webhook
Create a webhook destination. Webhooks are available on paid subscriptions only.
- Destructive
Update Webhook
Update an existing webhook destination. Webhooks are available on paid subscriptions only.
- Destructive
Delete Webhook
Delete a webhook destination. Webhooks are available on paid subscriptions only.
Orders
- Read
List Orders
Return list of recent orders.
- Read
Track Order
Return Summary of delivery status for the order.
- Read
List Order Items
Return the individual mail pieces that make up an order, one entry per recipient, with that piece's delivery status, delivery date, QR scan count, failure reason and recipient address.
- Write
Replay Order
Submit a copy of a previously placed order as a brand-new order. The same creative is charged and mailed again, and the original order is left untouched. By default the replay is sent to the recipients the original actually reached (failed items are excluded).
- Destructive
Cancel Order
If Order is in Reviewing Status, then this will cancel the order and refund the credits for the order back to your account. If the order can be successfully canceled, the status will be updated to cancelled.
- Destructive
Invalidate Gift Card
Invalidate the gift card on a mailed piece so it can no longer be redeemed, for example when a card was sent by mistake. This does the same as the Invalidate button on the Order Details page, and it can't be undone. PATCH is accepted as well as PUT.
No operations match.
See How connections work for access and permissions, or browse all integrations.