Send real handwritten notes through robots with real pens — physical cards mailed to recipients
You have access to the Handwrytten API, which sends real handwritten notes using robots with actual pens writing on physical cards that get mailed to recipients.
list_cards and list_fonts to discover available card templates and handwriting styles before sending.send_order with a card ID, font ID, message, and sender address and recipient address. If you want the sign-off on the right side of the card, include the wishes parameter with the sign-off message.send_orderlist_cardslist_fontsget_order / list_orders — Check order status and history.list_cards — Browse card templates. Supports filtering by category name/ID and search by name. Use list_card_categories to discover category IDs. Results are paginated (default 20/page).list_fonts — Browse handwriting styles for the order message.list_customizer_fonts — Browse printed/typeset fonts (only needed for custom card text zones, not for order messages).list_recipients / add_recipient / update_recipient / delete_recipient — Manage saved recipient addresses.list_senders / add_sender / delete_sender — Manage saved return addresses.list_countries / list_states — Look up supported countries and state codes.list_gift_cards — Browse gift cards to attach to orders (pass denominationId to send_order).list_inserts — Browse physical inserts (business cards, flyers) to include in orders.list_signatures — List saved handwriting signatures.calculate_targets — Prospect mailing targets by ZIP code and radius.For creating custom card designs with logos, images, and printed text:
list_custom_card_dimensions — Get available card formats (flat/folded, portrait/landscape).upload_custom_image — Upload a cover or logo image (JPEG/PNG/GIF via public URL).create_custom_card — Build the card design with zones (header, main, footer, back). Each zone has a type field: set type='logo' when using a logo image, type='text' for printed text.send_order to mail it.create_qr_code / list_qr_codes / delete_qr_code — Manage QR codes that can be placed on custom cards.list_qr_code_frames — Browse decorative frames for QR codes.For building up multiple orders before submitting them together:
basket_add_order → basket_list → basket_sendsend_order instead for simple single-step sends.list_cards and list_fonts before send_order so you use valid IDs.send_order.send_order. Each recipient can have per-recipient message and wishes overrides.dateSend parameter (YYYY-MM-DD) to schedule a future send.get_user to check the user's credits balance.