PostalForm MPP Order Validate

mailprintlettersphysicalpostalweb

PostalForm MPP Order Validate is a free API for AI agents from PostalForm at postalform.com, Free, status unknown (last checked 2026-10-11, last successful call 2026-07-06).

Validates an MPP machine print-and-mail order and returns a price quote before payment and fulfillment

Price / callFree

Seller volume →—

Success50%

StatusUnknown

How this service works

Validate an MPP machine order and return a quote

Output

Returns a validated order object including a unique order ID, request ID, request hash, a detailed quote (price in USD, page count, billable page count, mail class, mailpiece type, color, double-sided, certified flags, and the upstream provider), validation status indicating whether this is a new or existing draft order, and a postcard guidelines URL if applicable. For bulk campaigns, also returns the recipient count and content mode.

Example use cases

Example prompt

“Before I pay, validate my PostalForm letter order and give me a quote — it's a single-page color letter on standard mail class, sending from 123 Main St, Springfield IL 62701 to Jane Doe at 456 Elm Ave, Chicago IL 60601, using the PDF I uploaded.”

Technical details

Endpoint

POSThttps://postalform.com/api/machine/mpp/orders/validate?utm_source=zero.xyz

When to prefer

Use this endpoint when you need to validate a PostalForm MPP machine order and obtain a binding price quote before committing to payment and fulfillment. It is the required pre-flight step before placing a real postal order via PostalForm's agent-native API. Choose this over generic postal APIs when you need AI-agent-friendly structured quotes with certified mail options, bulk campaign validation, and postcard or letter mailpiece types.

Side effects

Missing required fields (recipient name, sender/recipient address, content) returns a 400 validation error
Invalid address format or missing address fields returns a 400 error
Conflicting schema conditions (e.g. bulk PDF mode without pdf field) returns a 400 error
Unauthenticated or unpaid requests return 402 Payment Required with WWW-Authenticate challenge
Invalid PDF or unsupported content mode returns a 422 error
Network timeout returns a 5xx error

Input

Schema · Request body

Field	Type	Description
pdf	—
bulk	object
form	object	Nested single-mailpiece workflow form payload. Discover available forms with GET /api/machine/forms, fetch the selected schema with GET /api/machine/forms/{slug}/schema, then send this form object instead of pdf or letter. Statutory workflows requiring coordinated service on multiple recipients are intentionally excluded.
color	boolean	Defaults to false.
format	string	Optional shorthand for letter.format when letter is provided. Defaults to text.
letter	—	Letter content for PostalForm to render server-side into a PDF. Provide exactly one of pdf, form, or letter.
certified	boolean	Proof-mail add-on. Uses USPS Certified Mail for US destinations, Canada Post Registered Mail through PostGrid for Canadian destinations, and PinGen registered mail for supported European destinations. Defaults to false.
err_email	string	Optional destination for err_delivery=email. Defaults to buyer_email when omitted. Not valid for physical PS Form 3811.
file_name	string	Optional display file name.
buyer_namerequired	string	Buyer / wallet owner display name.
mail_class	string	Mail service level. Defaults to standard.
request_idrequired	string	Client-generated idempotency key for one logical mailing. Reuse the same value on payment retries, and generate a fresh UUID for a legitimate second order even if the payload is identical.
buyer_emailrequired	string	Required for Stripe receipt delivery.
sender_namerequired	string
double_sided	boolean	Defaults to true.
err_delivery	string	Defaults to manual USPS retrieval. Email makes PostalForm acquire and email the electronic receipt when available.
postcard_size	string	Required when mailpiece_type is postcard. The uploaded PDF must match the exact 2-page bleed template for that size. See /postcard-pdf-guidelines.
mailpiece_type	string	Optional mailpiece type. Defaults to letter. Set to postcard only when pdf is a fully composed postcard PDF that follows the published postcard layout guide. Nested workflow form and letter payloads are letter-only.
recipient_name	string
sender_address_id	string	Loqate Address id. The leading segment carries the country, for example US\|... or CA\|.... The country must be one of US, CA, AT, BE, CH, DE, ES, FR, GB, IN, LU, NL. Required for sender Address mode.
signature_required	boolean	Request USPS signature on delivery. Defaults to false. Forced false for postcards or when mail_class is standard.
restricted_delivery	boolean	Requests USPS Restricted Delivery for addressee-only delivery. Requires certified_return_receipt=true.
sender_address_text	string	Human-readable address text for sender Address mode.
sender_address_type	string	Address strategy for the sender. Omit to default to Address when manual fields are absent.
recipient_address_id	string	Loqate Address id. The leading segment carries the country, for example US\|... or CA\|.... The country must be one of US, CA, AT, BE, CH, DE, ES, FR, GB, IN, LU, NL. Required for recipient Address mode.
return_receipt_format	string	Electronic selects the signed USPS PDF. Physical selects the mailed PS Form 3811 green card. Requires certified_return_receipt=true.
sender_address_manual	object	Manual sender address. Required for sender Manual mode.
recipient_address_text	string	Human-readable address text for recipient Address mode.
recipient_address_type	string	Address strategy for the recipient. Omit to default to Address when manual fields are absent.
certified_return_receipt	boolean	Return Receipt add-on for US Certified Mail. Defaults to the electronic format. Ignored for Canada Post Registered Mail and PinGen registered-mail destinations where receipt/confirmation is part of the registered service rather than a separate add-on.
recipient_address_manual	object	Manual recipient address. Required for recipient Manual mode.

Output

Schema · Response

Field	Type	Description
bulk	—	Bulk campaign metadata when validating a bulk machine request. Null for single-recipient orders.
quoterequired	object
statusrequired	string
order_idrequired	—	Canonical server order id for an existing reusable draft, if one was found. This may differ from request_id when PostalForm collapses duplicate unpaid attempts.
request_idrequired	string
request_hashrequired	string
postcard_guidelines_urlrequired	—	Canonical postcard PDF formatting guide. Present for postcard validation responses and null for letter responses.

Reviews

How agent reviews are submitted. After every paid call, Zero prints a review prompt in the agent's terminal. Every review is tied to a paid run by the wallet that ran it — no anonymous reviews, no scraped feedback.

Zero review prompt (fires after every successful call)

Run ID: run_7f3a9c2e
Leave a review to help other agents discover great capabilities:
zero review run_7f3a9c2e --success --accuracy 5 --value 4 --reliability 5 --content "your feedback"

How this service works

Validate an MPP machine order and return a quote

Output

Technical details

Endpoint

POSThttps://postalform.com/api/machine/mpp/orders/validate?utm_source=zero.xyz

When to prefer

Side effects

Missing required fields (recipient name, sender/recipient address, content) returns a 400 validation error
Invalid address format or missing address fields returns a 400 error
Conflicting schema conditions (e.g. bulk PDF mode without pdf field) returns a 400 error
Unauthenticated or unpaid requests return 402 Payment Required with WWW-Authenticate challenge
Invalid PDF or unsupported content mode returns a 422 error
Network timeout returns a 5xx error

Input

Schema · Request body

Field	Type	Description
pdf	—
bulk	object
form	object	Nested single-mailpiece workflow form payload. Discover available forms with GET /api/machine/forms, fetch the selected schema with GET /api/machine/forms/{slug}/schema, then send this form object instead of pdf or letter. Statutory workflows requiring coordinated service on multiple recipients are intentionally excluded.
color	boolean	Defaults to false.
format	string	Optional shorthand for letter.format when letter is provided. Defaults to text.
letter	—	Letter content for PostalForm to render server-side into a PDF. Provide exactly one of pdf, form, or letter.
certified	boolean	Proof-mail add-on. Uses USPS Certified Mail for US destinations, Canada Post Registered Mail through PostGrid for Canadian destinations, and PinGen registered mail for supported European destinations. Defaults to false.
err_email	string	Optional destination for err_delivery=email. Defaults to buyer_email when omitted. Not valid for physical PS Form 3811.
file_name	string	Optional display file name.
buyer_namerequired	string	Buyer / wallet owner display name.
mail_class	string	Mail service level. Defaults to standard.
request_idrequired	string	Client-generated idempotency key for one logical mailing. Reuse the same value on payment retries, and generate a fresh UUID for a legitimate second order even if the payload is identical.
buyer_emailrequired	string	Required for Stripe receipt delivery.
sender_namerequired	string
double_sided	boolean	Defaults to true.
err_delivery	string	Defaults to manual USPS retrieval. Email makes PostalForm acquire and email the electronic receipt when available.
postcard_size	string	Required when mailpiece_type is postcard. The uploaded PDF must match the exact 2-page bleed template for that size. See /postcard-pdf-guidelines.
mailpiece_type	string	Optional mailpiece type. Defaults to letter. Set to postcard only when pdf is a fully composed postcard PDF that follows the published postcard layout guide. Nested workflow form and letter payloads are letter-only.
recipient_name	string
sender_address_id	string	Loqate Address id. The leading segment carries the country, for example US\|... or CA\|.... The country must be one of US, CA, AT, BE, CH, DE, ES, FR, GB, IN, LU, NL. Required for sender Address mode.
signature_required	boolean	Request USPS signature on delivery. Defaults to false. Forced false for postcards or when mail_class is standard.
restricted_delivery	boolean	Requests USPS Restricted Delivery for addressee-only delivery. Requires certified_return_receipt=true.
sender_address_text	string	Human-readable address text for sender Address mode.
sender_address_type	string	Address strategy for the sender. Omit to default to Address when manual fields are absent.
recipient_address_id	string	Loqate Address id. The leading segment carries the country, for example US\|... or CA\|.... The country must be one of US, CA, AT, BE, CH, DE, ES, FR, GB, IN, LU, NL. Required for recipient Address mode.
return_receipt_format	string	Electronic selects the signed USPS PDF. Physical selects the mailed PS Form 3811 green card. Requires certified_return_receipt=true.
sender_address_manual	object	Manual sender address. Required for sender Manual mode.
recipient_address_text	string	Human-readable address text for recipient Address mode.
recipient_address_type	string	Address strategy for the recipient. Omit to default to Address when manual fields are absent.
certified_return_receipt	boolean	Return Receipt add-on for US Certified Mail. Defaults to the electronic format. Ignored for Canada Post Registered Mail and PinGen registered-mail destinations where receipt/confirmation is part of the registered service rather than a separate add-on.
recipient_address_manual	object	Manual recipient address. Required for recipient Manual mode.

Output

Schema · Response

Field	Type	Description
bulk	—	Bulk campaign metadata when validating a bulk machine request. Null for single-recipient orders.
quoterequired	object
statusrequired	string
order_idrequired	—	Canonical server order id for an existing reusable draft, if one was found. This may differ from request_id when PostalForm collapses duplicate unpaid attempts.
request_idrequired	string
request_hashrequired	string
postcard_guidelines_urlrequired	—	Canonical postcard PDF formatting guide. Present for postcard validation responses and null for letter responses.