Handwrytten integration

Check auth

Tool to verify API key authentication validity for Handwrytten. Use when you need to test if the API credentials are valid and properly configured.

Get basket all new

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 card details

Tool to get detailed information about a specific card in the Handwrytten catalog. Use when you need comprehensive details about a card including pricing, dimensions, images, and customization options.

Get list 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 user

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

Add recipient

Tool to add a recipient address to the user's addressbook in Handwrytten. Use when you need to store a new recipient for sending handwritten cards.

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

Clear basket

Tool to clear all items from the shopping basket. Use when you need to empty the basket and remove all pending items before starting a new order or canceling the current selection.

Create template

Tool to create a new template for the current user. Use when you need to save a new message template for sending handwritten cards.

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 recipient

Tool to delete one or more recipient addresses from user's profile. Use when you need to remove saved recipient addresses. Provide either address_id for single deletion or address_ids for bulk deletion.

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.

Logout

Tool to logout user from Handwrytten application. Use when you need to terminate the current user session and invalidate the authentication token.

Place basket

Tool to add an order to the basket in Handwrytten. Use when you need to create a new handwritten card order with specified recipients, card design, message, and delivery details. The order can be placed immediately or scheduled for future delivery.

Register user

Tool to register a new Handwrytten user account. Use when creating a new user with email and password. Sends activation email to user; user status is not_active until email is confirmed.

Request reset password

Tool to request a password reset email for a Handwrytten account. Use when a user needs to reset their password and requires an email with reset instructions. The API will send an email with a password reset link if the provided email exists in the system, but will return success regardless to prevent email enumeration attacks.