Card Mailer

Creates an unpaid order for the ready recipients in a saved list and the selected saved card design. Returns a cards.onmax.me link for the user to review recipients and pay. Nothing is printed, mailed or charged until the user pays on that page. Rows needing fixes are excluded. Each call creates a separate order link. An optional US sender address is printed as the return address.

Creates or edits a printed 5x7 postcard with a front greeting, optional photo, back message and sign-off. Downloads an attached photo or public HTTPS photo URL to cards.onmax.me. Without a photo, the greeting appears on a solid color. An existing design_id edits that design; omitted fields remain unchanged. The back message is user-written or user-approved text of up to 500 characters. Arranges supplied photos and text in a print template without generating images.

Corrects or removes a recipient in a saved list by row number. Supplied fields replace stored values; omitted fields remain unchanged. An unreadable row needs name, line1, city, state and zip. Rechecks required fields and US address format, plus USPS verification when configured. Format checks do not confirm deliverability. remove: true excludes the recipient. Lists belonging to paid orders cannot be changed.

Returns a Card Mailer order's payment, printing, mailing or delivery status, send date, estimated arrival and per-recipient counts. The mailing_id is the last part of the order link. Does not change the order or track other USPS mail.

Imports US postal recipients from pasted text, CSV or XLSX into a saved list. Checks required fields and US address format; USPS verification runs only when configured, and usps_checked reports whether it ran. Format checks do not confirm deliverability. Returns list_id, ready counts and row problems. An existing list_id appends recipients, up to 300. Not for email, non-US addresses or advertising to purchased or rented lists.

Calculates the unit price including First-Class postage, total for ready recipients, send date and estimated arrival window for a saved US recipient list. A saved design_id includes that design's current front and back preview. Null design_id produces a price-only quote with preview_included: false. arrive_by adds the latest safe send date and whether the requested date can be met. Does not create an order or charge money.