Skip to main content

Text → letter

Text paperplane’s iMessage number and it’ll turn the conversation into a letter order. Two ways to give it the recipient and the letter: Just say what you want mailed, in plain language:
paperplane asks whatever it’s missing (an address, the actual wording), quotes a price, and sends only after you reply with an explicit yes. Or use the structured fallback — the same TO: block convention as send by email, or a native iMessage Contact card:
Share a Contact card instead of typing the address and paperplane reads the name and postal address straight off it.

What happens

  1. A natural-language message goes through an AI read that asks clarifying questions and can call the same quote_letter / send_letter tools MCP agents use — the TO: block and Contact-card formats skip straight to deterministic parsing. Either way lands on the same recipient + letter text.
  2. We verify the address, quote a price, and reply with the total.
  3. Nothing is mailed until you reply with an explicit yes-style confirmation to that specific quote. A send_letter call is never executed as an actual send in the same turn it’s decided on — only a later, explicit confirmation against an already-priced quote spends it.
  4. We create the order and reply with the tracking link.

Notes

  • The recipient must be a real USPS-verifiable address, same as every other surface.
  • Like email, a message with nothing that resolves to an address gets a question back, not a guess.
  • A “yes” only ever confirms the specific quote it was minted for — the recipient, letter content, and price are bound to a single-use token, the same mechanism send_letter uses everywhere else.
  • Test mode: use sandbox-mode orders to test the full flow for free before sending real mail.
Last modified on September 16, 2026