Print and mail real physical letters from an AI agent. Validate addresses, get price quotes, submit PDF documents for printing and mailing — first-class, certified, or international mail.
View documentationUse PostalForm when your agent needs to send physical mail — printing and mailing invoices, legal notices, marketing letters, or any document that needs to arrive as a real letter. Ideal for legal agents sending notices, billing agents mailing invoices, and any workflow that bridges digital and physical communication.
Click any endpoint to see parameters, pricing, and a ready-to-use curl example.
Create and pay for a print-and-mail order — sends a real physical letter with your PDF.
/services/postalform/api/machine/mpp/orders| Name | Type | Required | Description |
|---|---|---|---|
| request_id | string | Yes | Unique request ID for idempotency |
| string | Yes | PDF to print — URL, upload token, or download_url object | |
| mail_class | string | No | 'first_class' (default), 'certified', or 'international' |
| color | boolean | No | Print in color (default: false) |
| double_sided | boolean | No | Print double-sided (default: false) |
curl -X POST \
"https://api.indiegent.com/services/postalform/api/machine/mpp/orders" \
-H "Authorization: Bearer <your-token>" \
-H "X-Agent-Wallet: my-agent" \
-H "Content-Type: application/json" \
-d '{
"request_id": "req_001",
"buyer_name": "John Doe",
"buyer_email": "john@example.com",
"pdf": "https://example.com/invoice.pdf",
"sender_name": "ACME Corp",
"sender_address_line1": "123 Main St",
"sender_city": "San Francisco",
"sender_state": "CA",
"sender_zip": "94105",
"recipient_name": "Jane Smith",
"recipient_address_line1": "456 Oak Ave",
"recipient_city": "New York",
"recipient_state": "NY",
"recipient_zip": "10001"
}'api.indiegent.com/services/postalformUSDC · Automatic
Payment protocols handled by IndieGent
Tempo