# PostalForm Machine Order

> PostalForm Machine Order is a paid API for AI agents from postalform.com, paid per call via x402, $3.4/call, status unknown (last checked 2026-10-11, last successful call 2026-06-10).

Submit a machine-generated order to print and physically mail a PDF letter to a recipient via postal service

## Facts

- Endpoint: POST https://postalform.com/api/machine/orders?utm_source=zero.xyz
- Price: $3.4/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Last successful call: 2026-06-10
- Success rate: 100% of calls made through Zero
- Rating: 4.7 / 5 from 2 reviews
- Activations on Zero: 4
- Tags: x402
- Canonical page: https://www.zero.xyz/c/postalform-com-ad23e0fd
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_nXhlRGfzjSgmPLnguDEBp

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability postalform-com-ad23e0fd -d '<json body>'
```

Example prompt: Send a real printed letter via PostalForm from me, Jane Smith at 123 Main St, Austin TX 78701 US, to John Doe at 456 Oak Ave, Denver CO 80203 US — use the PDF I just uploaded with token 'tok_abc123', and confirm delivery to jane@example.com.

## When to prefer this

Use this endpoint when an AI agent needs to dispatch a real, physically printed and mailed letter to a postal address — not an email or digital message. Ideal for automations that require formal postal communication, legal notices, or any workflow where a tangible paper letter is required. Pair with the Validate endpoint first to get a quote, and use the :Id endpoint afterward to poll order status.

## Known failure modes

- Invalid or expired PDF upload token returns an error
- Missing required address fields (line1, city, zip) causes validation failure
- Invalid countryCode or malformed ZIP code rejected
- Payment not provided or x402 payment challenge not resolved returns 402 Payment Required
- Duplicate request_id may be rejected or deduplicated
- Recipient or sender address undeliverable

## How this service works

Unauthenticated calls return 402 Payment Required when the order is ready to be paid. Retry the exact same body with PAYMENT-SIGNATURE after settlement.

## Output

An order confirmation containing an order ID that can be used to poll fulfillment status via the sibling :Id endpoint; confirms the letter has been queued for printing and physical mailing.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "pdf": {
   "type": "object",
   "required": [
    "upload_token"
   ],
   "properties": {
    "upload_token": {
     "type": "string"
    }
   }
  },
  "buyer_name": {
   "type": "string"
  },
  "request_id": {
   "type": "string"
  },
  "buyer_email": {
   "type": "string"
  },
  "sender_name": {
   "type": "string"
  },
  "recipient_name": {
   "type": "string"
  },
  "sender_address_type": {
   "enum": [
    "Manual"
   ],
   "type": "string"
  },
  "sender_address_manual": {
   "type": "object",
   "required": [
    "line1",
    "city",
    "zip"
   ],
   "properties": {
    "zip": {
     "type": "string"
    },
    "city": {
     "type": "string"
    },
    "line1": {
     "type": "string"
    },
    "state": {
     "type": "string"
    },
    "countryCode": {
     "enum": [
      "US",
      "CA",
      "AT",
      "BE",
      "CH",
      "DE",
      "ES",
      "FR",
      "GB",
      "IN",
      "LU",
      "NL"
     ],
     "type": "string"
    }
   }
  },
  "recipient_address_type": {
   "enum": [
    "Manual"
   ],
   "type": "string"
  },
  "recipient_address_manual": {
   "type": "object",
   "required": [
    "line1",
    "city",
    "zip"
   ],
   "properties": {
    "zip": {
     "type": "string"
    },
    "city": {
     "type": "string"
    },
    "line1": {
     "type": "string"
    },
    "state": {
     "type": "string"
    },
    "countryCode": {
     "enum": [
      "US",
      "CA",
      "AT",
      "BE",
      "CH",
      "DE",
      "ES",
      "FR",
      "GB",
      "IN",
      "LU",
      "NL"
     ],
     "type": "string"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "status": "payment_settled",
  "is_paid": true,
  "order_id": "00000000-0000-4000-8000-000000000001"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/postalform-com-ad23e0fd/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from postalform.com](https://www.zero.xyz/host/postalform.com/llms.txt)