Content
Automate a PostalForm guided form
PostalForm exposes published guided forms as machine-readable schemas. Each reference links to the browser workflow, the live JSON schema, and a request template generated from the same workflow definition.
How it works
Fill out form
Complete the guided fields online.
Preview PDF
Review the generated PDF before mailing.
We print and mail it via USPS.
How can an AI agent fill and mail a form?
PostalForm lets an AI agent discover a published form, fetch its field schema, and prepare the same document available in the guided browser workflow. The agent supplies user-confirmed answers and attachments, validates the request, and presents the PDF and price before the owner approves payment and physical mailing.
Choose the integration
| Path | Use when | Next step |
|---|---|---|
| Guided browser form | A person will fill and review the form | Open the guided form link below |
| MCP hosted checkout | An assistant prepares an unpaid draft for a person | Call postalform.get_form_schema, then postalform.create_form_order_draft |
| Machine API | An owner authorized an autonomous payment workflow | Fetch the schema, validate, then use MPP or x402 with explicit spending authority |
Published machine form references
Catalog and scope
The live catalog is GET /api/machine/forms. Follow next_cursor until it is null; the default page contains up to 50 forms and limit accepts up to 200. Search with q. This documentation includes published, indexable machine workflows only. Customer-assembled official forms and statutory multi-recipient pre-lien workflows are not supported by the single-mailpiece machine form API. A form page is not a promise that every mailing option or address is eligible.
Ready to get started?
Upload your PDF and we will handle printing and mailing.