PostalForm
OtherAvailable through Sponge
MPPx402
About PostalForm
Review the Service identity, supported languages, protocol versions, and source metadata discovered by the directory.Service details
Service Id
3e886045-ab39-4db9-b4c5-10b69d40ee98
Service origin
https://postalform.com
ListedSeptember 24, 2026, 11:40 PM
Last checkedNovember 8, 2026, 11:15 PM
Protocol details
SourceOpenAPI
Endpoints
Endpoint details are saved from the OpenAPI document. Authentication requirements and prices are advertised information, not a verified payment or access guarantee. The document may contain additional endpoints.POST/api/machine/flower-letters
Create or reuse an x402 flower-letter order
Unauthenticated calls return 402 Payment Required after PostalForm validates the Florist One product, delivery ZIP, delivery date, and final quote. A 202 settled_pending_webhook response means Stripe is verifying the transaction; poll status and do not pay again.POST/api/machine/flower-letters/validate
Validate an x402 flower-letter order and return a Florist One quote
GET/api/machine/flower-letters/{id}
Get x402 flower-letter order status
GET/api/machine/forms
List workflow forms available to machine order flows
Search published single-mailpiece PostalForm workflow forms that agents can fill and submit through the x402 or MPP machine order endpoints. Coordinated statutory multi-recipient workflows are excluded.GET/api/machine/forms/{slug}/schema
Get a machine-usable workflow form schema
POST/api/machine/mpp/flower-letters
Create or reuse an MPP flower-letter order
Unauthenticated calls return 402 Payment Required with WWW-Authenticate: Payment challenges after Florist One validation and quote.POST/api/machine/mpp/flower-letters/validate
Validate an MPP flower-letter order and return a Florist One quote
GET/api/machine/mpp/flower-letters/{id}
Get MPP flower-letter order status
POST/api/machine/mpp/orders
Create or reuse an MPP machine order
Unauthenticated calls return 402 Payment Required with WWW-Authenticate: Payment challenges. Retry the exact same body with Authorization: Payment after settlement.POST/api/machine/mpp/orders/validate
Validate an MPP machine order and return a quote
GET/api/machine/mpp/orders/{id}
Get MPP machine order status
POST/api/machine/mpp/orders/{id}/pay
Pay an existing MPP draft without resubmitting its document
Pay an existing MPP PDF, letter, workflow-form draft, or ordinary bulk-mail campaign. Create the draft through an MCP draft tool or create_machine_order with payment_protocol=mpp and buyer_email. Review its PDF preview or bulk campaign_url, recipients and total, then POST {} here to fetch this endpoint's WWW-Authenticate challenges. After buyer approval, retry the same endpoint with Authorization: Payment ... . Do not reuse a challenge from a different endpoint or resubmit documents or CSV. Paid or settled-pending-webhook orders are returned without charging again. Bulk responses include campaign_url and recipient/status counts.POST/api/machine/mpp/shipping-labels
Create, pay for, and download an MPP shipping label
The unpaid call persists the exact EasyPost shipment/rate and returns MPP challenges. Retry the identical body with Authorization: Payment. Immediate settlements purchase the persisted rate and return label_download_url in the receipt-bearing response; delayed settlements return 202 and complete through the status endpoint.POST/api/machine/mpp/shipping-labels/validate
Validate an MPP shipping-label request and return live rates
Creates an unpurchased EasyPost shipment to obtain live rates. The selected public total includes the live carrier rate, PostalForm service fee, and estimated payment-fee reserve.GET/api/machine/mpp/shipping-labels/{id}
Get MPP shipping-label payment, fulfillment, and download status
POST/api/machine/orders
Create or reuse an x402 machine order
Unauthenticated calls return 402 Payment Required when the order is ready to be paid. Retry the exact same body with PAYMENT-SIGNATURE after settlement. A 202 settled_pending_webhook response means Stripe is verifying the transaction; poll status and do not pay again.POST/api/machine/orders/validate
Validate an x402 machine order and return a quote
GET/api/machine/orders/{id}