ceven

Handwrytten

Sends physical handwritten notes and cards to your customers automatically based on triggers in your other SaaS tools.

Try Handwrytten in Ceven

Ask Ceven anything
Standard

Why use Ceven?

  1. AI native Handwrytten integration

    • Describe the outcome and Ceven picks the right Handwrytten 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 Handwrytten data, across all 48 of its actions.

  2. Managed auth

    • Built in OAuth with automatic token refresh and rotation.
    • One place to manage, scope, and revoke Handwrytten 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 Handwrytten, when, and on whose behalf.
    • The agent pauses and asks when Handwrytten is unclear instead of plowing ahead.

  4. Enterprise grade security

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

Supported tools

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

Add Recipient
Use this when you need to save a new address to the address book for future mailings.
Place Order in Basket
Use this to create a new card order with a specific recipient, message, and card design.
Create Template
Save a reusable message template to maintain consistent branding across different card campaigns.
List Cards
Pull a list of available card designs to select the right visual for a specific occasion.
List Fonts
Retrieve available handwriting fonts to match the personality of the sender.
List Recipients
Pull all saved recipient addresses to check for existing contacts before adding new ones.
Get Basket
Fetch the current state of the shopping basket including items and totals before checkout.
Clear Basket
Empty all items from the current basket to start a fresh order sequence.
List Orders
Retrieve a history of past orders to verify if a card was successfully sent.
Get Card Details
Pull specific pricing and customization options for a single card design.
List Signatures
Retrieve available signatures to append to the end of a handwritten note.
Delete Recipient Address
Remove one or more outdated addresses from the user profile.
Calculate Order Taxes
Tool to calculate taxes for Handwrytten basket orders. Use without any parameters for basket orders, or optionally provide order details to calculate taxes for a specific order (experimental).
Check Authentication
Tool to verify API key authentication validity for Handwrytten. Use when you need to test if the API credentials are valid and properly configured.
Create User Address
Tool to create a new user address in Handwrytten. Use when adding a new return address to a user's profile for sending handwritten cards.
Delete Custom Image
Tool to delete a custom image/logo from Handwrytten. Use when you need to remove a previously uploaded custom image or logo from your account.
Delete Template
Tool to delete a user's template by its ID. Use when you need to remove a saved template from the user's account.
Get Basket (New Method)
Tool to retrieve the user's basket using the new method. Use when you need to fetch the current state of the shopping basket with all items, billing information, and totals.
Get Basket Count
Tool to retrieve the count of items currently in the basket. Use when you need to check how many items are in the shopping basket before proceeding with checkout or additional operations.
Get Basket Item
Tool to retrieve a basket item by its ID from Handwrytten. Use when you need to get details of a specific basket item.
Get List of Addresses
Tool to retrieve a list of all addresses associated with the user's account. Use when you need to view or select from saved addresses for sending handwritten cards.
Get Random Cards
Tool to retrieve random cards from Handwrytten. Use when you need to get a random selection of greeting cards from the Handwrytten catalog.
Get Template Details
Tool to get detailed information about a card text template in the Handwrytten catalog. Use when you need to view the template message content and details.
Get Current User Info
Tool to retrieve information about the currently authenticated user. Use when you need to fetch user profile details, account information, or verify authentication status.
Get User Address
Tool to retrieve the authenticated user's address and billing information. Use when you need to access user profile address details.
List Basket Orders Grouped
Tool to list all basket orders grouped by basket. Use when you need to retrieve all items currently in the user's basket or review pending orders.
List Past Baskets
Tool to retrieve a list of user's past baskets. Use when you need to view historical basket information including orders, recipients, and totals.
List Categories
Tool to retrieve the list of available card categories from Handwrytten. Use when you need to display category options or filter cards by category.
List Countries
Tool to retrieve the list of countries available in Handwrytten. Use when you need to get available countries for sending handwritten cards.
List Credit Cards
Tool to list all credit cards associated with the Handwrytten account. Use when you need to retrieve stored payment methods and billing information.

30 actions · scroll to see them all

Frequently asked questions

Ceven does not handle the mail itself. It acts as the orchestration layer that tells Handwrytten what to write and where to send it. Once Ceven triggers the Place Order action, the request goes to the Handwrytten API. Their robotic systems then physically write the note with a real pen on actual cardstock and drop it into the postal system. You can use the List Orders action via Ceven to track when these requests were processed, but the actual delivery speed depends on the postal service used by Handwrytten for that specific region.
Yes. Handwrytten allows for custom images and logos. You can manage these through the account settings or by using the specific image management tools. Once an image is uploaded and approved by the Handwrytten team, Ceven can reference that image ID when placing orders to ensure your branding appears on the physical card. This is particularly useful for corporate gifting where a company logo needs to appear on the card face or the envelope to ensure the recipient recognizes the sender immediately.
If an address is invalid, the Handwrytten system will typically flag the order during the processing phase. Ceven can monitor order history through the List Orders tool to identify failed deliveries. However, because these are physical goods, some errors are only discovered after the card has left the facility. We recommend using the Add Recipient tool to validate addresses through your own CRM first before pushing the data into Handwrytten to minimize waste and ensure your physical mail reaches the intended destination.
Yes. Handwrytten imposes API rate limits to ensure their robotic fleet is not overwhelmed by sudden bursts of traffic. If a Ceven workflow attempts to send thousands of cards in a single second, you may encounter a rate limit error. To handle this, Ceven implements an internal queuing system that staggers the API calls. This ensures that your large scale campaigns are processed smoothly without triggering a block from the Handwrytten API, though it may take slightly longer for all orders to enter the basket.
Absolutely. Handwrytten provides a variety of fonts that mimic different human handwriting styles. Through the List Fonts action, Ceven can retrieve all available styles. You can then build logic into your workflow to assign a specific font based on who the sender is. For example, a note from the CEO might use a more formal script while a note from a junior account manager uses a more casual print. This adds an extra layer of authenticity to the physical correspondence.
Handwrytten uses a basket model similar to online shopping. Instead of a single send command, Ceven typically adds an item to the basket using the Place Order in Basket tool. Once all cards for a specific batch are added, the basket is processed. This allows Ceven to group multiple orders together. You can use the Get Basket tool to verify the contents and totals before the final order is committed, giving you a chance to audit the costs of a large campaign before the robots start writing.
Yes. You can upload a scan of your actual signature to Handwrytten. Ceven can then call the List Signatures tool to find the correct signature ID for the sender. When the agent places the order, it attaches that signature ID to the card. This means the card looks completely handwritten from the greeting to the sign off, making it nearly impossible for the recipient to tell that a robot was involved in the process.
Ceven can trigger international sends as long as the destination country is supported by Handwrytten. You can use the List Countries tool to see the current list of supported regions. If you attempt to send a card to a country not on that list, the Handwrytten API will return an error which Ceven will report back to you in the workflow logs. We recommend checking the country list dynamically within your workflow before attempting to create a recipient address for international clients.

Alternatives to Handwrytten

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

Postable logoPostableInkpact logoInkpactHandwrytten logoHandwrytten

Try Ceven on your stack

Plug Ceven on top of the tools you already run. Connect Handwrytten 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