{"uid":"cap_dLakfAbpAGsn0MrWxnvKM","slug":"mailpulse-physical-letter-send-86490cbb","name":"MailPulse Physical Letter Send","description":"MailPulse sends REAL physical letters — US First-Class, US Certified Mail, or international — via x402 micropayments. Action, not data: free quote, paid send, optional tracking. Powered by Lob.","url":"https://mailpulse.theaslangroupllc.com/api/letters/%7Bid%7D","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"type":"object","properties":{}},"type":{"type":"string","const":"http"},"method":{"enum":["POST","PUT","PATCH"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"errors":{"type":"object","description":"Documented error responses, keyed by HTTP status code","additionalProperties":{"type":"object","required":["description"],"properties":{"example":{"type":"object"},"description":{"type":"string"}}}},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"id":"ltr_...","mode":"test","status":"rendered","carrier":"USPS","tracking_number":null,"expected_delivery_date":"2026-07-23"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","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":"$0.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_8SfXuzSzWopu_InV_ANAv","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Sends a real physical letter via USPS (First-Class, Certified Mail, or international) using x402 micropayments, powered by Lob","exampleAgentPrompt":"Send a real physical letter via USPS First-Class to Jane Smith at 123 Main St, Austin TX 78701 — the letter should be from Acme Corp at 456 Oak Ave, New York NY 10001 and say 'Dear Jane, your account has been updated. Please contact us if you have questions.'","exampleUseCases":[{"title":"Legal notice via certified mail","prompt":"Send a certified mail letter to Robert Johnson at 789 Elm Street, Chicago IL 60601 from my law firm at 100 LaSalle St, Chicago IL 60602 — the content is a formal notice of contract termination. I need tracking so I can confirm delivery."},{"title":"Automated customer invoice mailing","prompt":"Mail a physical invoice letter to our client TechCorp at 500 Market St, San Francisco CA 94105 — it's from Billing Dept at 200 Pine St, Portland OR 97201, and the letter text is 'Dear TechCorp, please find your invoice #1042 for $2,500 attached. Payment due in 30 days.' Use US First-Class mail."},{"title":"International letter to overseas contact","prompt":"Send a physical letter internationally to Maria Garcia at Calle Mayor 10, Madrid 28013, Spain — from us at 300 Fifth Ave, New York NY 10001. The message is 'Dear Maria, we are pleased to confirm your partnership agreement. We look forward to working together.'"}],"resultDescription":"Returns a JSON object with the letter ID (ltr_...), mode (test/live), current status (e.g. rendered, mailed), carrier (USPS), optional tracking number if Certified Mail was selected, and expected delivery date.","failureModes":["Invalid or undeliverable address returns an address validation error","Missing required fields (recipient, sender, content) result in a 400 bad request","Insufficient USDC balance or failed x402 payment results in a 402 payment required error","International addresses not supported for certain mail classes return a service restriction error","Letter ID path parameter malformed or missing causes a 404 or routing error"],"whenToPreferThis":"Choose this endpoint when you need to physically mail a real letter via USPS — including First-Class, Certified Mail with tracking, or international delivery — and want to pay per-send via x402 micropayments without a monthly subscription. Prefer this over email or SMS APIs when a legal paper trail, certified delivery proof, or formal physical document is required. Ideal for agents automating invoice mailing, legal notices, or customer communications that must arrive as tangible paper.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T06:30:35.100Z","isFirstParty":false}