Postcard PDF generator

Generate a Postcard PDF via the API

POST your data to /api/v1/generate and get a PDF back. Copy-paste an example, swap in your API key, and loop over a list to render thousands — one postcard per record.

curl -X POST https://pdfgen.com/api/v1/generate \
  -H "Authorization: Bearer pdfg_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "html": "<div style=\"padding:28px;font-family:-apple-system,BlinkMacSystemFont,Segoe UI,Roboto,Helvetica,Arial,sans-serif;color:#111827;\">\n  <div style=\"max-width:560px;margin:0 auto;border-radius:14px;overflow:hidden;box-shadow:0 12px 32px rgba(0,0,0,.15);\">\n    <div style=\"height:200px;background:linear-gradient(135deg,#f59e0b,#ef4444);position:relative;\">\n      <div style=\"position:absolute;bottom:18px;left:24px;color:#fff;\">\n        <p style=\"font-size:13px;letter-spacing:3px;text-transform:uppercase;margin:0;opacity:.9;\">Greetings from</p>\n        <h1 style=\"font-size:38px;font-weight:800;margin:4px 0 0;text-shadow:0 2px 8px rgba(0,0,0,.25);\">{{destination}}</h1>\n      </div>\n    </div>\n    <div style=\"background:#fff;padding:24px;display:flex;gap:20px;\">\n      <div style=\"flex:1;font-size:14px;color:#374151;line-height:1.6;font-family:Georgia,serif;\">{{message}}</div>\n      <div style=\"width:160px;font-size:12px;color:#6b7280;border-left:1px solid #e5e7eb;padding-left:16px;\">\n        <div style=\"width:46px;height:54px;border:2px solid #e5e7eb;border-radius:4px;margin:0 0 12px auto;\"></div>\n        <p style=\"margin:0;font-weight:600;color:#111827;\">{{to.name}}</p>\n        <p style=\"margin:4px 0 0;white-space:pre-line;\">{{to.address}}</p>\n      </div>\n    </div>\n  </div>\n</div>",
    "engine": "handlebars",
    "format": "A5",
    "data": {
      "destination": "Lisbon",
      "message": "Having an amazing time exploring the old town and tasting all the pastéis de nata. Wish you were here — see you soon!",
      "to": {
        "name": "Alex Carter",
        "address": "742 Evergreen Terrace\nPortland, OR 97201"
      }
    }
  }' --output postcard.pdf

import fs from "node:fs";

// The Handlebars template (edit once, reuse for every render).
const template = "<div style=\"padding:28px;font-family:-apple-system,BlinkMacSystemFont,Segoe UI,Roboto,Helvetica,Arial,sans-serif;color:#111827;\">\n  <div style=\"max-width:560px;margin:0 auto;border-radius:14px;overflow:hidden;box-shadow:0 12px 32px rgba(0,0,0,.15);\">\n    <div style=\"height:200px;background:linear-gradient(135deg,#f59e0b,#ef4444);position:relative;\">\n      <div style=\"position:absolute;bottom:18px;left:24px;color:#fff;\">\n        <p style=\"font-size:13px;letter-spacing:3px;text-transform:uppercase;margin:0;opacity:.9;\">Greetings from</p>\n        <h1 style=\"font-size:38px;font-weight:800;margin:4px 0 0;text-shadow:0 2px 8px rgba(0,0,0,.25);\">{{destination}}</h1>\n      </div>\n    </div>\n    <div style=\"background:#fff;padding:24px;display:flex;gap:20px;\">\n      <div style=\"flex:1;font-size:14px;color:#374151;line-height:1.6;font-family:Georgia,serif;\">{{message}}</div>\n      <div style=\"width:160px;font-size:12px;color:#6b7280;border-left:1px solid #e5e7eb;padding-left:16px;\">\n        <div style=\"width:46px;height:54px;border:2px solid #e5e7eb;border-radius:4px;margin:0 0 12px auto;\"></div>\n        <p style=\"margin:0;font-weight:600;color:#111827;\">{{to.name}}</p>\n        <p style=\"margin:4px 0 0;white-space:pre-line;\">{{to.address}}</p>\n      </div>\n    </div>\n  </div>\n</div>";

const res = await fetch("https://pdfgen.com/api/v1/generate", {
  method: "POST",
  headers: {
    Authorization: "Bearer pdfg_live_xxx",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    html: template,
    engine: "handlebars",
    format: "A5",
    data: {
      "destination": "Lisbon",
      "message": "Having an amazing time exploring the old town and tasting all the pastéis de nata. Wish you were here — see you soon!",
      "to": {
        "name": "Alex Carter",
        "address": "742 Evergreen Terrace\nPortland, OR 97201"
      }
    },
  }),
});

fs.writeFileSync("postcard.pdf", Buffer.from(await res.arrayBuffer()));

import requests

# The Handlebars template (edit once, reuse for every render).
template = "<div style=\"padding:28px;font-family:-apple-system,BlinkMacSystemFont,Segoe UI,Roboto,Helvetica,Arial,sans-serif;color:#111827;\">\n  <div style=\"max-width:560px;margin:0 auto;border-radius:14px;overflow:hidden;box-shadow:0 12px 32px rgba(0,0,0,.15);\">\n    <div style=\"height:200px;background:linear-gradient(135deg,#f59e0b,#ef4444);position:relative;\">\n      <div style=\"position:absolute;bottom:18px;left:24px;color:#fff;\">\n        <p style=\"font-size:13px;letter-spacing:3px;text-transform:uppercase;margin:0;opacity:.9;\">Greetings from</p>\n        <h1 style=\"font-size:38px;font-weight:800;margin:4px 0 0;text-shadow:0 2px 8px rgba(0,0,0,.25);\">{{destination}}</h1>\n      </div>\n    </div>\n    <div style=\"background:#fff;padding:24px;display:flex;gap:20px;\">\n      <div style=\"flex:1;font-size:14px;color:#374151;line-height:1.6;font-family:Georgia,serif;\">{{message}}</div>\n      <div style=\"width:160px;font-size:12px;color:#6b7280;border-left:1px solid #e5e7eb;padding-left:16px;\">\n        <div style=\"width:46px;height:54px;border:2px solid #e5e7eb;border-radius:4px;margin:0 0 12px auto;\"></div>\n        <p style=\"margin:0;font-weight:600;color:#111827;\">{{to.name}}</p>\n        <p style=\"margin:4px 0 0;white-space:pre-line;\">{{to.address}}</p>\n      </div>\n    </div>\n  </div>\n</div>"

res = requests.post(
    "https://pdfgen.com/api/v1/generate",
    headers={"Authorization": "Bearer pdfg_live_xxx"},
    json={
        "html": template,
        "engine": "handlebars",
        "format": "A5",
        "data": {
            "destination": "Lisbon",
            "message": "Having an amazing time exploring the old town and tasting all the pastéis de nata. Wish you were here — see you soon!",
            "to": {
                "name": "Alex Carter",
                "address": "742 Evergreen Terrace\nPortland, OR 97201"
            }
        },
    },
)

with open("postcard.pdf", "wb") as f:
    f.write(res.content)

Working in another language? Follow a full guide for your stack:

Related templates