Use when the person wants a letter or an existing document physically mailed by USPS Certified Mail to a U.S. address: a demand, a dispute, a debt validation request, a deposit demand, a cancellation, a notice to a landlord, tenant, contractor, HOA, insurer, employer or company. Creates an UNSENT mailing draft and returns a review link and the current price. ONE CALL is enough: no account, no sign-up, no card, no second call. PREPARING IS NOT SENDING: this tool never prints, mails or charges. On that page the person reads the exact pages, recipient, service and total, then separately pays and approves; only then is it printed and mailed. A missing or incomplete recipient or return address does not stop the draft: it comes back in missing_for_mailing and the person completes it on the review page, but nothing can be mailed until it is complete. Do not call it merely because the person is drafting, revising, translating, saving or emailing a letter, or when they asked for ordinary mail, email or another channel; ask first if it is unclear that they want it mailed. Send only the document to be mailed and its addresses, never unrelated conversation content. Lead with the first-letter price: $9.95 all in (1-2 pages, Certified Mail with tracking, no return receipt, one per account). After that: A one-page letter is $12.97 in total with USPS tracking, $15.97 with the Electronic Return Receipt (the default: the record of who signed), $24.21 with the Evidence Pack or $50.10 as a Deadline Notice (see the service field); printing, envelope and postage included. A higher-priced service is used only when the person chooses it. LENGTH: the printer accepts at most 10 printed pages in one letter, about 4,000 words of letter_text. Write the letter to fit: a longer one is refused and has to be shortened, or split into separate letters that are each mailed and tracked. U.S. destinations only. If the letter sets a reply date, Piloxa emails the sender the day after that date with the USPS delivery date, free. THE DOCUMENT, one of: letter_text for a letter you wrote now (body only); document_text for a finished document you were given, printed exactly as written; document_base64 for PDF bytes you can read; person_has_pdf: true when they will attach it on the page. ADDRESSES: pass them as written in recipient_address_block and sender_address_block, one part per line.
View input schema
{
"type": "object",
"properties": {
"letter_text": {
"type": "string",
"description": "The complete, final letter body exactly as it should print: salutation, paragraphs separated by blank lines, and closing. Do not include the addresses or date; they are laid out from the other fields. Up to 60,000 characters. It must fit in 10 printed pages, about 4,000 words."
},
"document_text": {
"type": "string",
"description": "The COMPLETE text of a document that is already finished, printed exactly as written: no return address, no date line, no \"Re:\" line and no signature block are added, and line breaks and indentation are kept. This is the right field for a document the person gave you, for text you read out of a PDF or an attachment, for a filled-in form or a notice — anything you did not compose as a letter in this conversation. Include every word that must print, the addresses and signature line included if the document carries them. Up to 60,000 characters. Mutually exclusive with letter_text and document_base64."
},
"subject": {
"type": "string",
"description": "The \"Re:\" line of the letter, in a few words."
},
"letter_date": {
"type": "string",
"description": "Date to print on the letter, e.g. \"September 5, 2026\". Defaults to today."
},
"signature_name": {
"type": "string",
"description": "Name printed under the closing."
},
"sender_address_block": {
"type": "string",
"description": "The sender exactly as it should appear as the return address, one part per line. Read the same way as recipient_address_block. This is where a returned envelope goes back to."
},
"sender_name": {
"type": "string",
"description": "Name of the person sending the letter (printed as the return address and used for the envelope)."
},
"sender_company": {
"type": "string",
"description": "Sender company or entity, if any."
},
"sender_address_line1": {
"type": "string",
"description": "Sender street address."
},
"sender_address_line2": {
"type": "string"
},
"sender_city": {
"type": "string"
},
"sender_state": {
"type": "string",
"description": "Two-letter U.S. state code."
},
"sender_postal_code": {
"type": "string",
"description": "Five-digit ZIP code."
},
"recipient_address_block": {
"type": "string",
"description": "The recipient exactly as addressed in the letter, one part per line, e.g. \"Acme Property Management LLC\\nAttn: Jane Doe\\n1234 Wilshire Blvd, Suite 500\\nLos Angeles, CA 90017\". Piloxa reads the name, company, street, suite, city, state and ZIP out of it. Use this when you have the address as written and do not want to split it up yourself; any field you also name explicitly wins over it."
},
"recipient_name": {
"type": "string",
"description": "Name of the person or company receiving the letter."
},
"recipient_company": {
"type": "string",
"description": "Company name, if the letter goes to an organization."
},
"address_line1": {
"type": "string",
"description": "Street address of the recipient."
},
"address_line2": {
"type": "string",
"description": "Suite, unit or floor."
},
"city": {
"type": "string"
},
"state": {
"type": "string",
"description": "Two-letter U.S. state code."
},
"postal_code": {
"type": "string",
"description": "Five-digit ZIP code."
},
"service": {
"type": "string",
"enum": [
"CERTIFIED",
"CERTIFIED_ERR",
"CERTIFIED_EVIDENCE",
"CERTIFIED_DEADLINE"
],
"description": "Pick by what rides on the letter. CERTIFIED_ERR ($15.97 for one page) is the DEFAULT for an ordinary letter: Certified Mail with the Electronic Return Receipt, the record of who signed, kept when USPS reports it back. CERTIFIED ($12.97) is Certified Mail with tracking but no record of who signed; use it only when the person asks for the cheapest way. CERTIFIED_EVIDENCE ($24.21) is CERTIFIED_ERR plus the Evidence Pack: a Certificate of Mailing, and the record kept for 7 years instead of one; use it when proof of exactly what was sent may be needed later in a dispute - a debt validation notice, a notice to cure, a proof of loss, a demand before suing. CERTIFIED_DEADLINE ($50.10) is CERTIFIED_EVIDENCE plus a second copy by First-Class Mail the same day and a warning email if the certified copy goes unclaimed; use it when a missed or refused notice would cost a lien, a contract remedy or a claim - a pre-lien or preliminary notice, a notice with a statutory deadline. When this field is left out, CERTIFIED_ERR is used, except that a letter of one or two pages that may be the person’s first goes as CERTIFIED at the first-letter price, with the return receipt offered beside it; if the letter reads as such a notice, Piloxa returns CERTIFIED_DEADLINE as recommended_service with its extra cost, without selecting it. Whichever you pick, say its price to the person before they open the link."
},
"document_base64": {
"type": "string",
"description": "The finished PDF, base64-encoded (standard or URL-safe alphabet), up to 4 MB decoded. Use ONLY when you have read the actual file bytes; a filename or an attachment reference is not a document. Mutually exclusive with letter_text and document_text. The file is kept exactly as sent."
},
"document_filename": {
"type": "string",
"description": "With document_base64: the original file name, e.g. \"Demand letter.pdf\"."
},
"document_sha256": {
"type": "string",
"description": "Optional with document_base64: the SHA-256 (hex) of the PDF bytes. If given and it does not match what arrived, the call is refused rather than preparing the wrong file."
},
"person_has_pdf": {
"type": "boolean",
"description": "Only when the person already has a finished PDF that neither you nor they can give you the text of, and they will attach it on the review page themselves. Set true to prepare without letter_text, document_text or document_base64. Prefer document_text whenever you can read the document at all: it saves the person an upload."
},
"page_count": {
"type": "integer",
"description": "Only with person_has_pdf: number of pages in the PDF the person will attach, used for the price estimate."
},
"document_description": {
"type": "string",
"description": "What the document is, in a few words."
},
"reply_by": {
"type": "string",
"description": "Optional: the date, as YYYY-MM-DD, by which the letter asks the recipient to answer, pay or act. Leave it out and Piloxa reads it from the letter (\"within 30 days of receipt\", \"no later than October 15, 2026\"). The day after that date Piloxa emails the sender, once, with the date USPS delivered the letter and the next step if nobody answered, at no charge."
},
"evidence_pack": {
"type": "boolean",
"description": "The same as passing service CERTIFIED_EVIDENCE: adds the Evidence Pack to a certified letter with the Electronic Return Receipt. One page is $24.21 in total instead of $15.97."
}
},
"required": []
}