Ecosystem/PostalForm

PostalForm

Tempo
Other3 endpointsDynamic pricing

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 documentation

When should an agent use this?

Use 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.

Endpoints

Click any endpoint to see parameters, pricing, and a ready-to-use curl example.

Paid (1)

Create and pay for a print-and-mail order — sends a real physical letter with your PDF.

Path/services/postalform/api/machine/mpp/orders
MethodPOST
PriceDynamic (varies per request)

Parameters

NameTypeRequiredDescription
request_idstringYesUnique request ID for idempotency
pdfstringYesPDF to print — URL, upload token, or download_url object
mail_classstringNo'first_class' (default), 'certified', or 'international'
colorbooleanNoPrint in color (default: false)
double_sidedbooleanNoPrint double-sided (default: false)

Example Request

curl
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"
}'

Free (2)

IndieGent Endpoint

api.indiegent.com/services/postalform

Payment

USDC · Automatic

Payment protocols handled by IndieGent

Network

Tempo

IndieGentIndieGent — Independent wallets for independent agents

npm install -g @indiegent/cli