Description
n8n-nodes-podpdf
An n8n community node for PodPDF. It turns HTML, Markdown, URLs and templates into PDFs with the PodPDF API.
Installation
Self-hosted n8n: go to Settings → Community Nodes → Install, enter n8n-nodes-podpdf and confirm. See n8n’s community node installation guide.
Credentials
1. Sign in at https://app.podpdf.com and open Settings → API Keys to create a key.
2. In n8n, create a PodPDF API credential and paste the key into API Key.
n8n checks the key by calling GET https://api.podpdf.com/me. Requests send it in the X-API-Key header.
New PodPDF accounts get 10 free PDFs; after that PDFs cost $0.01 each. When the free PDFs and credits run out, the API returns 403 INSUFFICIENT_CREDITS.
Operations
The File resource works on a PDF already on the item, read from a binary field: an email
attachment, a download, or a PDF this node made earlier. Up to 4 MB goes to the API inline;
anything larger is uploaded first, and the signed upload URL never carries the credential.
Edit PDF sends a commit token derived from the document, the recipe and the day, so a retried
step replays the first result instead of being charged again.
| Resource | Operation | API call | Notes |
| — | — | — | — |
| PDF | Generate PDF | POST /quickjob | HTML, Markdown or a public HTTPS URL. Up to 25 pages and 30 seconds. |
| PDF | Render Template | POST /templates/{id}/render | Template ID (from My templates in the dashboard), a JSON Data object, and an optional Filename. |
| Job | Start Long Job | POST /longjob | HTML or Markdown, up to 100 pages. With Wait for Completion turned on, the node polls every 5 seconds for up to 3 minutes and then returns the download link. |
| Job | Get Job | GET /jobs/{id} | Status: queued, processing, completed, partial_failed, failed or timeout. |
| Job | Get Download Link | GET /jobs/{id}/download | Returns a new signed URL, valid for 1 hour. |
| File | Merge PDFs | POST /pdf/merge | Two or more binary fields on the item, in order, with an optional page range for each. Up to 4 MB in total. |
| File | Split PDF | POST /pdf/split | Each page, every N pages, page ranges, or extract. Returns one item per part, each with its own PDF. |
| File | Edit PDF | POST /pdf/edit | A recipe of operations applied in order, charged once: watermarks, stamps, page changes, metadata, sanitize, forms and annotations. |
| File | Inspect PDF | POST /pdf/inspect | Page count, page IDs and sizes, and the form fields. Free, and the step to run before writing a recipe. |
Options for Generate PDF and Start Long Job are Format (A4, Letter, Legal, A3, A5, Tabloid), Landscape, Margin (one value for all sides, such as 20mm), Print Background, Scale (0.1–2) and Page Ranges (such as 1-3, 5). The node sends only the options you add.
Download File (Generate PDF and Render Template; on by default) downloads the PDF and outputs it as the binary property data (application/pdf). The JSON response is kept, including jobid, pages and downloadurl. Turn it off if you only need the link.
Errors
API errors appear as CODE: message, for example INSUFFICIENTCREDITS: … or QUICKJOBTIMEOUT: …. For a timeout, switch to Start Long Job. When Continue On Fail is on, the error goes into the item’s error field and the workflow keeps running.
Example workflow
Manual Trigger → PodPDF (PDF → Generate PDF, Input Type: HTML, HTML:
Invoice {{ $json.number }}
) → Gmail (Send, attachment field data)
Resources
- API docs: https://apidocs.podpdf.com
- Website: https://podpdf.com
- Support: podpdfapp@gmail.com
