Install
Run directly with npx, or install globally:
Quote a letter
Free, creates nothing:
Send a letter
--from is required — USPS requires a return address on every letter — or
set PAPERPLANE_FROM once instead of passing it every time. --sandbox runs
the whole flow (upload, screening, simulated fulfillment, a tracking number)
instantly and free, and mails nothing.
Check status
Configuration
Addresses
One line: "Name, Street, City ST ZIP", or with a second line:
"Name, Street, Line2, City ST ZIP".
Payment
Every order carries its own payment — a prepaid credit code
(--credit-code pp-xxxx-xxxx-xxxx) for hands-off scripts, or a Stripe payment
link a human approves. Sandbox orders need neither.
The CLI is a thin wrapper over the same REST API —
see the quickstart for everything the CLI doesn’t cover.Last modified on September 15, 2026
