Warmly Written

By Warmly Written

Overview

Somewhere in your camera roll is a photo someone you love would keep forever. Warmly Written turns it into a work of art and puts it in their mailbox. Share a photo: Mom laughing, the dog, the day you got engaged. Pick a style (Watercolor, Storybook Anime, Cartoon 3D or Charcoal Sketch) and watch your photo become art in under a minute. Tell us what to say, up to 500 characters. We print a 5×7 card on heavy stock, we write your note in real ink, and we mail it for you, usually within two business days. Most cards arrive in about a week. You see the art before you decide anything. No account. You finish your order on warmlywritten.com. Your photo is used to make and print your card and nothing else: never sold, never used for marketing. US addresses only. We're a small, woman-owned studio run by a husband-and-wife team. We think a card printed by the millions can't say what your own photo can.

Tools

change_style

ChatGPT

Use this when the person wants the same photo in a different style (no new upload needed), or to try again after the art didn't finish. If the card already has art in that style, it switches back to it at no cost. Not available once the card has an order; start a new card instead.

create_card

ChatGPT

Use this when the person has shared a photo and chosen a style for a card to be mailed. Starts a new card: turns the photo into art in that style and returns a preview. Send exactly one photo: photo_url (a public https link to the image), photo_base64 (with photo_mime_type; up to about 2.5 MB — for a larger photo send photo_url) or photo_file. JPEG, PNG or WebP; for an iPhone HEIC photo, send it as a JPEG. The art usually takes under a minute; if the status is painting, call get_card to wait for it. Nothing is ordered or charged. Not for photo editing with no card intended.

create_order

ChatGPT

Use this only after the person has seen their preview, said they want to mail it, and okayed the details you read back. Gets the card ready to mail: saves the message, the recipient's US mailing address, the sender's name and return address and the buyer's email, and returns a pay link on warmlywritten.com. Give the person the pay link as the place to review the card and pay (for example: 'Review & pay: <link>'). Nothing is charged or mailed until the person pays on that page. Call it again to change any detail before they pay; the pay link stays the same. If the address needs confirming, it returns the address to confirm instead; ask the person, then call it again with address_choice. Not for addresses outside the US.

get_card

ChatGPT

Use this when create_card or change_style answered with status painting, to wait for the preview, or later when the person asks where their card is. Returns a card's current state: the art status and preview and, once it has an order, the order status, total and mailing date. Waits up to about 35 seconds while the art is being made. Order status updates twice a day.

list_styles

ChatGPT

Use this when someone wants to send a physical greeting card made from their photo and hasn't picked a style, or asks about Warmly Written, what a card costs or how long it takes. Lists the art styles, each with a sample image, plus the price, the 5x7 card format, where we mail to and how long mailing takes. Not for e-cards, digital invitations or printing at home.