{"uid":"cap_RO2lIMiJqU2_VzS7uCRUh","slug":"postagent-print-mail-9eab8b4e","name":"PostAgent Print & Mail","description":"Print and mail physical US letters (PDF, HTML, Markdown, DOCX, or image) and postcards via USPS, paid in USDC — with certified/registered proof options and standalone address verification at POST /v1/verify. Integration flow: POST /v1/documents to upload, POST /v1/quotes to lock a fixed USDC price for a recipient, then pay the returned per-quote x402 URL to create and mail the piece. Price is fixed per quote.","url":"https://api.postagent.sh/v1/print?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["POST"],"type":"string"},"queryParams":{"type":"object","properties":{"webhookUrl":{"type":"string","description":"Optional HTTPS URL that receives job status webhooks after the letter is created."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"1.24","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$1.24/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"1.24","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"1.24","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_uNua6kcOlDWoeGl-aW8BU","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"1.24","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Prints and mails a physical US letter or postcard via USPS, paid in USDC using the x402 payment protocol","exampleAgentPrompt":"Send this HTML invoice as a physical USPS letter to Jane Smith at 123 Main St, Austin TX 78701 — I already have a quote locked in, so go ahead and pay and mail it, and notify me at https://myapp.com/webhooks/mail when it's done.","exampleUseCases":null,"resultDescription":"Returns a job confirmation indicating the letter or postcard has been created and queued for USPS mailing, along with a job ID and status. If a webhookUrl was provided, the endpoint will POST job status updates (e.g. printed, mailed, delivered) to that URL as the piece moves through the mail system.","failureModes":["Invalid or expired quote ID — must re-run POST /v1/quotes to get a fresh locked price","Payment failure — USDC payment via x402 not completed or insufficient funds","Invalid recipient address — address failed USPS verification (use POST /v1/verify first)","Unsupported document format — file type not in PDF/HTML/Markdown/DOCX/image set","Document ID not found — must upload via POST /v1/documents before calling /v1/print","Webhook URL unreachable — optional webhookUrl returns non-2xx during registration"],"whenToPreferThis":"Use this endpoint when you need to physically mail a document to a US address via USPS, especially when paying programmatically in USDC. Prefer this over email or digital delivery when legal proof of delivery (certified/registered mail) is required, when the recipient has no digital access, or when a physical postcard or letter is the required medium. It fits well into agentic workflows that handle invoicing, legal notices, government correspondence, or marketing mail entirely in code.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":1,"lastUsedAt":"2026-10-08T10:08:46.084Z","lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-12T05:29:49.058Z","isFirstParty":false,"canonicalSlug":"postagent-print-mail-9eab8b4e"}