n8n-nodes-pdfmint

Turn HTML, Markdown or a URL into a PDF and get the file back on the same node.

No template editor. No template IDs to copy out of a web app. No second HTTP Request
node to fetch the file. No container to self-host.

Seven published n8n templates built on this node — all openable from inside n8n:
PDF invoices from webhook
requests,
Stripe payment receipts with Gmail and
Drive,
Weekly web page snapshot
archive,
Form submissions to branded PDF
reports,
Overdue invoice statements from
Xero,
Weekly AR ageing reports with Invoice
Ninja,
and Markdown to branded PDFs with a table of
contents.
More on pdf.mintapis.com/n8n-templates.

One more, Regional sales reports from CRM
exports,
is listed here for completeness but is built on the sibling node
n8n-nodes-docmint, not on this one.

PDFMint is the API behind it.
The free plan is 10 documents a month and needs no card — enough to wire the node up and see a
real PDF. Anything recurring needs Starter, at $9 a month for 5,000 documents.

Install

Installs on n8n Cloud and self-hosted. The node passed n8n's verification and is
published as a verified community node. n8n serves whichever version it has verified
most recently, which can trail the latest npm release by a day or two.

n8n Cloud: open any workflow → add node → search PDFMint under Community nodes.

Self-hosted, from the n8n UI

Settings → Community Nodes → Install → n8n-nodes-pdfmint

Self-hosted, from the CLI

cd ~/.n8n/nodes
npm install n8n-nodes-pdfmint

Then restart n8n.

The package is published from
this repository's GitHub Actions workflow with an npm
provenance attestation, so npm audit signatures can verify which commit built it.

See a real PDF before you sign up

There is a demo endpoint that needs no account and no key. Paste this into a terminal
and you get a real PDF file back:

curl -X POST https://pdf.mintapis.com/v1/demo/pdf \
  -H 'content-type: application/json' \
  -d '{"html":"<h1>Hello</h1><p>Rendered by PDFMint.</p>"}' \
  -o hello.pdf

It answers 200 application/pdf. Open hello.pdf — that is the same renderer the node
uses. It is rate limited per IP and is meant for exactly this: checking that the output
is what you want before you hand over an email address.

Credential

1. Create an account at https://pdf.mintapis.com/signup. Your API key is shown
   immediately — no email confirmation, no card.
2. In n8n, add a PDFMint API credential and paste the key. It starts with pm_live_.
3. The credential tests itself against GET /v1/me, so you know straight away whether it works.

Operations

The node is marked usableAsTool, so an n8n AI Agent can call it directly — give the
agent the node and it can produce a PDF as part of its own reasoning.

Quick start — an invoice from workflow data

Drop a PDFMint node after whatever produces your data and set:

• Source: HTML

• HTML: an expression that yields your markup, for example

  {{ $json.invoiceHtml }}
  

• Options → Margin: 18mm

• Options → Page Numbers: on

Execute the node. The output item carries the PDF in the data binary field, ready for
Gmail, Google Drive, S3, Slack or an HTTP Request — no extra download step.

Markdown in, typeset document out

Set Source to Markdown and pass Markdown straight through. This is the short path
when an LLM node upstream produced the content:

{{ $json.output }}

PDFMint applies a print stylesheet for you: tables that do not split a row across a page
break, headings that do not orphan at the bottom of a page, code that wraps instead of
clipping, and bundled fonts that cover Latin, CJK and emoji.

Placeholders that do not fail silently

Any source can carry {{placeholder}} markers filled from Placeholder Data:

<h1>Invoice {{number}}</h1>
<p>For {{customer.name}}</p>
{{#lines}}<tr><td>{{desc}}</td><td>{{amount}}</td></tr>{{/lines}}
{{^lines}}<p>No items.</p>{{/lines}}

If a placeholder has no matching value, the node tells you: the output item carries a
warning naming every unresolved placeholder. Turn on Strict Placeholders to make it
fail the item instead. It never quietly hands you a blank page.

Options

Everything below lives under Options and is optional.

Output modes

Merging

Set the operation to Merge PDFs. With All Input Items, the node takes one PDF from
each incoming item — so a Split In Batches loop that generates several documents can be
joined by connecting it straight into this node. With List of URLs, paste one public
PDF URL per line.

Merge runs once for the whole branch, not once per item.

Long documents

Most documents finish in well under a second, and the synchronous path allows up
to 120 seconds. For anything longer, set Options → Webhook URL (Async) to the
Production URL of a Webhook node. The PDFMint node then returns a job ID
immediately and PDFMint POSTs

{ "job_id": "job_...", "status": "succeeded", "url": "https://…/f/…", "pages": 12, "size": 481203 }

to your webhook when the document is ready, retrying three times with backoff.
Jobs are stored in the database, not in memory, so a restart cannot lose one.
GET /v1/jobs/{id} reports the status either way.

When the PDF comes out wrong

Turn on Options → Return Debug Info. The output item then also carries the
HTML that was actually rendered — after placeholders were filled and after the
browser parsed it — plus any JavaScript errors the page threw. That is usually
enough to see the problem without guessing.

Errors

The API answers failures with a machine code, a sentence, and a concrete hint. The node
puts the sentence in the error title and the hint plus a docs link in the description, so
the red box in n8n tells you what to change rather than Request failed with status 400.

Turn on Settings → Continue On Fail to route bad items down the error branch instead.
The failed item carries the API's own fields, so an IF node can branch on $json.error.code:

{
  "error": {
    "code": "invalid_api_key",
    "message": "This API key is not valid, or it has been revoked.",
    "hint": "…",
    "docs": "https://pdf.mintapis.com/docs#authentication",
    "request_id": "51e5390e4107f566",
    "httpCode": "401"
  },
  "errorMessage": "This API key is not valid, or it has been revoked."
}

rate_limited (429), renderer_busy (503) and the 502s are all worth retrying — turn on
Settings → Retry On Fail and n8n handles them for you.

Limits

Pages behind a login are not reachable — PDFMint renders on its own servers, so fetch
those in your workflow and pass the HTML instead. Private and link-local addresses are
refused.

Pricing

Images and merges each count as one document. The free plan is permanent and needs no card, but at
10 documents a month it is sized for trying the node out rather than running a workflow. Checkout
for a paid plan runs on Stripe, where a VAT ID can optionally be added to the invoice.

Links

• Docs: https://pdf.mintapis.com/docs
• Dashboard: https://pdf.mintapis.com/dashboard
• API source: https://github.com/fstandhartinger/pdfmint
• Issues: https://github.com/fstandhartinger/n8n-nodes-pdfmint/issues

Reading email rather than writing PDFs? That is the opposite job and a different node:
n8n-nodes-mailmint, by the same author —
an inbound address or an IMAP mailbox in, structured JSON out, with the message's own SPF,
DKIM and DMARC verdict attached. It has passed n8n's verification too, so it installs on n8n
Cloud as well as self-hosted.

Filling Word, Excel or PowerPoint templates from JSON is
n8n-nodes-docmint.

Compatibility

Built and tested against n8n 2.35 on Node.js 20 and 22. The package has zero runtime
dependencies — it is a thin HTTP client.

Licence

MIT