{"uid":"cap_nXhlRGfzjSgmPLnguDEBp","slug":"postalform-com-ad23e0fd","name":"PostalForm Machine Order","description":"Unauthenticated calls return 402 Payment Required when the order is ready to be paid. Retry the exact same body with PAYMENT-SIGNATURE after settlement.","url":"https://postalform.com/api/machine/orders?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"pdf":{"type":"object","required":["upload_token"],"properties":{"upload_token":{"type":"string"}}},"buyer_name":{"type":"string"},"request_id":{"type":"string"},"buyer_email":{"type":"string"},"sender_name":{"type":"string"},"recipient_name":{"type":"string"},"sender_address_type":{"enum":["Manual"],"type":"string"},"sender_address_manual":{"type":"object","required":["line1","city","zip"],"properties":{"zip":{"type":"string"},"city":{"type":"string"},"line1":{"type":"string"},"state":{"type":"string"},"countryCode":{"enum":["US","CA","AT","BE","CH","DE","ES","FR","GB","IN","LU","NL"],"type":"string"}}},"recipient_address_type":{"enum":["Manual"],"type":"string"},"recipient_address_manual":{"type":"object","required":["line1","city","zip"],"properties":{"zip":{"type":"string"},"city":{"type":"string"},"line1":{"type":"string"},"state":{"type":"string"},"countryCode":{"enum":["US","CA","AT","BE","CH","DE","ES","FR","GB","IN","LU","NL"],"type":"string"}}}}},"responseSchema":{"type":"json","example":{"status":"payment_settled","is_paid":true,"order_id":"00000000-0000-4000-8000-000000000001"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"3.4","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":2,"rating":{"score":"0.92","successRate":"1.00","reviews":2,"stars":"4.7","state":"rated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$3.4/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"3.4","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"3.4","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_BwlueiRBRuyS9F2-_WO_l","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"3.4","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Submit a machine-generated order to print and physically mail a PDF letter to a recipient via postal service","exampleAgentPrompt":"Send a real printed letter via PostalForm from me, Jane Smith at 123 Main St, Austin TX 78701 US, to John Doe at 456 Oak Ave, Denver CO 80203 US — use the PDF I just uploaded with token 'tok_abc123', and confirm delivery to jane@example.com.","exampleUseCases":null,"resultDescription":"An order confirmation containing an order ID that can be used to poll fulfillment status via the sibling :Id endpoint; confirms the letter has been queued for printing and physical mailing.","failureModes":["Invalid or expired PDF upload token returns an error","Missing required address fields (line1, city, zip) causes validation failure","Invalid countryCode or malformed ZIP code rejected","Payment not provided or x402 payment challenge not resolved returns 402 Payment Required","Duplicate request_id may be rejected or deduplicated","Recipient or sender address undeliverable"],"whenToPreferThis":"Use this endpoint when an AI agent needs to dispatch a real, physically printed and mailed letter to a postal address — not an email or digital message. Ideal for automations that require formal postal communication, legal notices, or any workflow where a tangible paper letter is required. Pair with the Validate endpoint first to get a quote, and use the :Id endpoint afterward to poll order status.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":4,"lastUsedAt":"2026-06-10T22:59:37.331Z","lastSuccessfullyRanAt":"2026-06-10T22:59:37.331Z","lastHealthCheckAt":"2026-10-11T18:35:03.104Z","isFirstParty":false,"canonicalSlug":"postalform-com-ad23e0fd"}