Prepare a postcard.

Text, a photo, or your own front and back artwork.

Start with the complete test-mode recipe. Every postcard has two sides and an explicit recipient and sender.

Templates

Everyday note

{
  "id": "everyday_note",
  "version": "1",
  "kind": "postcard",
  "name": "Everyday note",
  "required_variables": [
    "message"
  ],
  "optional_variables": [
    "title"
  ]
}

Photo postcard

{
  "id": "photo_postcard",
  "version": "1",
  "kind": "postcard",
  "name": "Photo postcard",
  "required_variables": [
    "message",
    "image_asset_id"
  ],
  "optional_variables": [
    "title"
  ]
}

Artwork

Upload one PDF page or image for each side. Print-ready files must match 6.25×4.25 inch dimensions including bleed. Images need at least 1875×1275 pixels. Leave the address/postage region clear.

Safe commit

Always inspect the proof. Send the same revision, quote ID, manifest hash, and maximum price. Retry with the same idempotency key.