ceven

Thanks.io

Triggers personalized physical mailings based on digital events and manages recipient lists to bridge the gap between CRM data and the physical mailbox.

Try Thanks.io in Ceven

Ask Ceven anything
Standard

Why use Ceven?

  1. AI native Thanks.io integration

    • Describe the outcome and Ceven picks the right Thanks.io calls, fills the parameters, and checks the result.
    • Structured, agent friendly tool schemas so each call runs reliably instead of by guesswork.
    • Rich coverage for reading, writing, and querying your Thanks.io data, across all 29 of its actions.

  2. Managed auth

    • Built in OAuth with automatic token refresh and rotation.
    • One place to manage, scope, and revoke Thanks.io access.
    • Per user and per environment credentials instead of shared keys.

  3. Agent optimized design

    • Actions are tuned from real success and error rates so reliability climbs over time.
    • Full execution logs so you always know what ran in Thanks.io, when, and on whose behalf.
    • The agent pauses and asks when Thanks.io is unclear instead of plowing ahead.

  4. Enterprise grade security

    • Fine grained access so you control which agents and people can reach Thanks.io.
    • Least privilege by default, read scopes first and only the writes a workflow needs.
    • A full audit trail of every Thanks.io action to support review and sign off.

Supported tools

Every action Ceven's agents can run on Thanks.io, and when to use it.

Send Postcard
Use this when you need to dispatch a physical postcard with a chosen image and handwritten message immediately.
Create Mailing List
Use when you need to group contacts under a fresh list before adding recipients.
Add Recipient to Mailing List
Use after confirming recipient and list ids to add a new person to a specific mailing group.
Execute Stored Send
Use after creating a stored send to trigger the actual delivery of the mail piece.
List Handwriting Styles
Pull available handwriting styles to select the best look for personalized mail.
Preview Postcard
Use when you need front and back images to confirm the design before placing an order.
Buy Radius Search List
Use when you need targeted mailing lists centered around a specific address and distance.
Search Orders by Name
Use when you need to find all physical orders sent to a specific recipient full name.
Get Recipient Details
Pull a specific recipient record by id to verify their full address and custom fields.
Update Recipient
Use when modifying recipient data after confirming the recipient exists in the system.
Stored Send Notecard
Use when you need to schedule the mailing of a personalized notecard at a later time.
List Orders
Pull recent order history, optionally filtering by sub account or limiting the result count.
Create Sub Account
Use when you need to manage separate profiles with distinct return addresses and settings.
List Message Templates
Pull available message templates to use as a basis for a new mailing.
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.
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.
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.
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.
Search Orders by Recipient Full Name
Tool to search orders by recipient full name. use when you need to find all orders sent to a specific recipient.
Order Summary Statistics
Tool to retrieve order summary statistics for a date range. use when analyzing order volume and value filtered by type, status, or date range.
Proof Postcard
Tool to generate a pdf proof of a postcard's front and back. use when you need a preview pdf before sending the final postcard.
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.
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]."

30 actions · scroll to see them all

Frequently asked questions

Ceven accesses the list of available handwriting styles through the Thanks.io API. When you define a workflow, you can specify which style to use or let the agent pick one based on the desired tone of the message. The agent passes the specific style ID along with the personalized message text during the send request. This ensures that the final physical product looks authentic and personal rather than like a standard printed business letter. You can preview these styles using the preview tools before committing to a large batch of mailings to ensure the aesthetic matches your brand guidelines.
Yes, but we recommend using the stored send and preview features for high stakes mail. You can build a workflow where Ceven creates a stored send and generates a PDF preview, then sends that preview to a Slack channel for a quick thumbs up. Once the human approves, another workflow triggers the execute stored send action. Alternatively, for low risk campaigns like thank you notes, you can set the agent to bypass the preview and send the mail the moment a trigger occurs in your CRM, creating a truly hands free physical marketing loop.
Thanks.io performs address validation during the recipient creation and mailing process. If an address is flagged as undeliverable, the API response will indicate the failure. Ceven can be configured to catch these errors and immediately create a task in your CRM for a human to verify the address. This prevents you from paying for mail that will never reach the destination. The agent can also search for alternative addresses if you have multiple contact points for a single person, ensuring the highest possible delivery rate for your physical campaigns.
Sub accounts are critical for users who manage multiple brands or different return addresses. Ceven can list all available sub accounts and then scope subsequent actions to a specific sub account ID. This allows a single Ceven agent to handle mailings for an entire agency, routing the correct return address and billing profile based on which client the lead belongs to. You can create new sub accounts via the agent or update existing return address details without ever leaving the Ceven interface, keeping all your brand identities organized and separate.
While Ceven can trigger thousands of requests, you must be aware of Thanks.io API rate limits which vary by your subscription tier. If a workflow attempts to add ten thousand recipients in a single burst, Thanks.io may return a rate limit error. Ceven handles this by implementing an exponential backoff strategy, queuing the remaining requests and retrying them once the window resets. This ensures that no mail pieces are missed during large scale campaigns, though it may take slightly longer for the entire batch to be processed by the Thanks.io system.
Yes, by using the buy radius search mailing list action. You can tell the agent to find all households within a five mile radius of a specific property address and add them to a new Thanks.io mailing list. Once the list is acquired, the agent can automatically trigger a postcard send to every person on that list. This is particularly powerful for real estate agents who want to announce a new listing to the immediate neighborhood without having to manually source and upload lead lists from a third party provider.
For every type of mail, Thanks.io provides a preview endpoint. When the agent triggers a preview, it receives a URL to a PDF or image of the front and back of the piece. Ceven can fetch these URLs and present them to you in the chat or post them to a project management tool. This is essential for checking that the handwritten font did not wrap awkwardly or that the image template is aligned correctly. Once you verify the visual output, you can proceed to the final order with confidence that the physical mail will look exactly as intended.
Ceven uses the list orders and order summary statistics tools to monitor the lifecycle of your mail. After a send is triggered, the agent can periodically check the order status to see when the piece has moved from pending to sent. This status can be pushed back into your CRM as a timestamped activity. This gives your sales team visibility into exactly when a prospect received a physical touchpoint, allowing them to time their follow up phone calls or emails to coincide with the arrival of the mail in the physical mailbox.

Alternatives to Thanks.io

Other tools that solve a similar problem. Ceven supports these too, so you can switch or run more than one at once.

Lob logoLobPostGrid logoPostGridStannp logoStannp

Try Ceven on your stack

Plug Ceven on top of the tools you already run. Connect Thanks.io and the rest of your stack, describe the outcome, and its agents handle the work end to end, days of it in minutes.

Get started for free