How do I send raw HTML in Postman without n8n?

Base64-encode the UTF-8 HTML string (Buffer.from(html, 'utf8').toString('base64') or your language equivalent) and put the result in templateFileData with templateFileType HTML. The API treats templateFileData uniformly as a Base64 blob or an HTTPS URL.

Generate Document (Single)

Q: Can I send both documentDataText and documentDataFile?

No. Either documentDataText OR documentDataFile is required, not both. The API expects exactly one data source. Omit the unused field from your Postman body.

Q: Which output types are allowed for each templateFileType?

Docx, MailMerge, GoogleDocs templates support PDF or Docx output. HTML template only outputs HTML. PDF template only outputs PDF. The template engine drives the allowed outputs.

Q: Does KeepPdfEditable apply to every request?

No. KeepPdfEditable only applies when outputType is PDF. For HTML or Docx output the API ignores the flag. Set true only when you want the rendered PDF to keep its AcroForm field definitions editable.

What this endpoint does

PDF4me Generate Document (Single) renders a single document by merging a template (Word, HTML, or PDF) with a data payload (JSON, XML, or CSV) in one REST call. The template can be Base64, a public URL, or raw HTML. The data can be inline text, a Base64-encoded file, or a URL. Returns the rendered PDF, Docx, or HTML as binary (200) or via a Location-header poll URL (202).

Authenticating Your API Request

Every PDF4me REST call must include your API key in the Authorization header as Basic auth. Get or rotate your key from the developer dashboard.

Get your API Key

Endpoint

POST/api/v2/GenerateDocumentSingle

Postman URLhttps://api.pdf4me.com/api/v2/GenerateDocumentSingle

Important Facts You Should Not Miss

Either documentDataText or documentDataFile

Exactly one data source must be set, not both with content. Use documentDataText for inline JSON / XML / CSV. Use documentDataFile for a Base64-encoded data file or a public URL.

Allowed outputType depends on templateFileType

Docx, MailMerge, GoogleDocs accept PDF or Docx. HTML accepts HTML only. PDF accepts PDF only. Exact casing matters.

Async returns 202 + Location header

With IsAsync: true the API may respond 202 and a Location header. GET that URL (same Authorization) until 200 with the rendered file (standard pdf4meAsyncRequest pattern).

HTTP setup

Method: POST
URL: https://api.pdf4me.com/api/v2/GenerateDocumentSingle
Content-Type: application/json
Authorization: Basic <your PDF4me API key>

Send IsAsync: true in the body. 200 returns the rendered file bytes. 202 returns a Location header with a poll URL; GET that URL with the same Authorization header until 200.

Variant matrix (Postman-relevant)

Pick one template variant (T1 / T2 / T3) and one data variant (D1 / D2 / D3). Six combinations cover every call.

Template (`templateFileData`)

Code	Source	Postman value in `templateFileData`	Also required
T1	Base64	Base64 template file (strip data:...;base64, prefix if present)	templateFileName
T2	URL	Full HTTPS URL string (not downloaded by the API request body)	templateFileName
T3	HTML code	Base64-encoded UTF-8 HTML: Buffer.from(html, "utf8").toString("base64")	templateFileName, templateFileType: HTML

Document data (one of two API fields)

Code	Source	API field	Postman value
D1	Text	`documentDataText`	Raw JSON / XML / CSV string
D2	Base64	`documentDataFile`	Base64 of the data file (strip data-URL prefix if present)
D3	URL	`documentDataFile`	Full HTTPS URL to .json / .xml / .csv

Rule: exactly one of documentDataText or documentDataFile must be set. Omit the unused field from the body.

Common combinations

#	Template	Data	Typical use
1	T1 Docx base64	D1 JSON text	Word mail-merge to PDF
2	T2 Docx URL	D3 JSON URL	Hosted template + hosted data
3	T3 HTML	D1 JSON text	HTML mustache rendered to HTML / PDF
4	T1 PDF form	D2 JSON base64	PDF template + encoded data file
5	T2 MailMerge URL	D1 XML text	Word merge fields + inline XML

templateFileType → allowed outputType

`templateFileType`	Allowed `outputType`	Notes
`Docx`	PDF, Docx	PDF4me Word template
`MailMerge`	PDF, Docx	Mail merge Word
`GoogleDocs`	PDF, Docx	Google Docs export style
`HTML`	HTML only	Mustache in HTML
`PDF`	PDF only	PDF form / template

API body fields

Always sent

Field	Required	Type	Notes
`templateFileType`	Yes	string	Docx, HTML, PDF, MailMerge, GoogleDocs
`templateFileName`	Yes	string	With extension, e.g. template.docx, template.html, template.pdf
`templateFileData`	Yes	string	Base64 template, or template URL string
`documentDataType`	Yes	string	Json, XML, or Csv (exact casing)
`outputType`	Yes	string	PDF, Docx, or HTML (see allowed-output table above)
`IsAsync`	Yes	boolean	true

Document data (one path)

Field	Required when	Type	Notes
`documentDataText`	D1 (text)	string	Valid JSON when documentDataType is Json; XML must look like XML; CSV non-empty
`documentDataFile`	D2 or D3	string	Base64 data file or URL to data file

Optional

Field	When	Default
`KeepPdfEditable`	outputType is PDF	false
`documentDataFile`	D1 text path is used	Omitted
`documentDataText`	D2 or D3 path is used	Omitted

Validation rules

Check	Detail
Template URL	Non-empty, valid URL.
Template base64	Non-empty after optional data-URL strip.
HTML code	Only when templateFileType is HTML. Empty is rejected. Auto-wraps <html> if missing.
JSON text	Must parse successfully with JSON.parse.
XML text	Must start with < and contain >.
CSV text	Non-empty after trim.
Either data source	documentDataFile or documentDataText is required.

Placeholder samples

Item	Example
Template URL (Docx)	https://example.com/template.docx
Template name	template.docx / template.html / template.pdf
Data URL (JSON)	https://example.com/data.json
Data file name	data.json
JSON text	{"name": "John Doe", "email": "[email protected]", "items": [{"product": "Widget", "price": 29.99}]}
XML text	<?xml version="1.0"?><root><name>John Doe</name></root>
CSV text	name,email\nJohn Doe,[email protected]
HTML template	<!DOCTYPE html>...{{title}}...

Sample payloads

1. Word template (base64) + JSON text → PDF

{
 "templateFileType": "Docx",
 "templateFileName": "template.docx",
 "templateFileData": "UEsDBBQAAAAI...",
 "documentDataType": "Json",
 "documentDataText": "{\"name\": \"John Doe\", \"email\": \"[email protected]\", \"items\": [{\"product\": \"Widget\", \"price\": 29.99}]}",
 "outputType": "PDF",
 "KeepPdfEditable": false,
 "IsAsync": true
}

2. Word template (URL) + JSON data (URL) → PDF

{
 "templateFileType": "Docx",
 "templateFileName": "template.docx",
 "templateFileData": "https://example.com/template.docx",
 "documentDataType": "Json",
 "documentDataFile": "https://example.com/data.json",
 "outputType": "PDF",
 "KeepPdfEditable": false,
 "IsAsync": true
}

3. Word template (base64) + JSON data (base64) → Word output

documentDataFile holds base64 of the JSON file bytes (not the parsed object).

{
 "templateFileType": "Docx",
 "templateFileName": "template.docx",
 "templateFileData": "UEsDBBQAAAAI...",
 "documentDataType": "Json",
 "documentDataFile": "eyJuYW1lIjogIkpvaG4gRG9lIn0=",
 "outputType": "Docx",
 "IsAsync": true
}

4. HTML template (base64 of HTML file) + JSON text → HTML

For raw HTML in Postman, send the same payload the n8n node would: base64-encoded HTML in templateFileData.

{
 "templateFileType": "HTML",
 "templateFileName": "template.html",
 "templateFileData": "PCFET0NUWVBFIGh0bWw+...",
 "documentDataType": "Json",
 "documentDataText": "{\"title\": \"Invoice\", \"heading\": \"Hello\", \"content\": \"World\"}",
 "outputType": "HTML",
 "IsAsync": true
}

5. Mail merge (URL) + XML text → PDF

{
 "templateFileType": "MailMerge",
 "templateFileName": "template.docx",
 "templateFileData": "https://example.com/template.docx",
 "documentDataType": "XML",
 "documentDataText": "<?xml version=\"1.0\" encoding=\"UTF-8\"?><root><name>John Doe</name><email>[email protected]</email></root>",
 "outputType": "PDF",
 "IsAsync": true
}

6. PDF form template (base64) + CSV text → PDF (editable)

{
 "templateFileType": "PDF",
 "templateFileName": "template.pdf",
 "templateFileData": "JVBERi0xLjQKJcfsj6IK...",
 "documentDataType": "Csv",
 "documentDataText": "name,email\nJohn Doe,[email protected]",
 "outputType": "PDF",
 "KeepPdfEditable": true,
 "IsAsync": true
}

7. Google Docs style (base64) + JSON URL → Docx

{
 "templateFileType": "GoogleDocs",
 "templateFileName": "template.docx",
 "templateFileData": "UEsDBBQAAAAI...",
 "documentDataType": "Json",
 "documentDataFile": "https://example.com/data.json",
 "outputType": "Docx",
 "IsAsync": true
}

Postman collection tips

Body

Use raw JSON. The API does not accept form-data for this endpoint.

Base64 of data

For D2, base64-encode the whole .json / .xml / .csv file and put it in documentDataFile. Set documentDataType accordingly.

HTML template

For T3 in Postman: Buffer.from(html, "utf8").toString("base64"). Send the base64 in templateFileData with templateFileType: HTML.

Filename match

Match the extension in templateFileName to templateFileType: .docx for Word / MailMerge / GoogleDocs, .html for HTML, .pdf for PDF.

Save response

Save the response body as .pdf, .docx, or .html depending on outputType.

curl example

curl -X POST https://api.pdf4me.com/api/v2/GenerateDocumentSingle \
 -H "Content-Type: application/json" \
 -H "Authorization: Basic YOUR_API_KEY" \
 -d '{
 "templateFileType": "Docx",
 "templateFileName": "template.docx",
 "templateFileData": "https://example.com/template.docx",
 "documentDataType": "Json",
 "documentDataFile": "https://example.com/data.json",
 "outputType": "PDF",
 "KeepPdfEditable": false,
 "IsAsync": true
 }' \
 --output generated.pdf

Quick reference: required vs optional by variant

Field	T1+D1	T2+D3	T1+D2	T3+D1	Any PDF out
`templateFileType`	Req	Req	Req	Req	Req
`templateFileName`	Req	Req	Req	Req	Req
`templateFileData`	Req (b64)	Req (URL)	Req (b64)	Req (b64 HTML)	Req
`documentDataType`	Req	Req	Req	Req	Req
`outputType`	Req	Req	Req	Req	Req
`documentDataText`	Req	Omit	Omit	Req	Omit
`documentDataFile`	Omit	Req (URL)	Req (b64)	Omit	Omit
`IsAsync`	Req	Req	Req	Req	Req
`KeepPdfEditable`	Opt	Opt	Opt	N/A*	Opt if PDF

*KeepPdfEditable only applies when outputType is PDF; the API forces false otherwise.

Code samples

FAQ

Can I send both documentDataText and documentDataFile in one request?+

No. Exactly one data source must be set. Omit the unused field. Sending both with content is rejected by the validation layer.

Which output types are allowed for each templateFileType?+

Docx, MailMerge, and GoogleDocs accept PDF or Docx. HTML accepts HTML only. PDF accepts PDF only. The casing of outputType matters.

Does KeepPdfEditable apply to every request?+

No. It only applies when outputType is PDF. For HTML or Docx output the API forces false and ignores the flag.

How do I send raw HTML in Postman?+

Base64-encode the UTF-8 HTML string (Buffer.from(html, "utf8").toString("base64") or the equivalent in your language). Put the result in templateFileData with templateFileType: HTML.

How do I encode the data file for D2?+

Base64-encode the entire .json, .xml, or .csv file bytes, not the parsed object. Put the base64 string in documentDataFile and set documentDataType to match.

How does the async flow work?+

Send IsAsync true. If the API returns 200, the rendered file is in the body. If 202, read the Location header for a poll URL. GET that URL with the same Authorization. Poll until 200.

My template Base64 has a data: prefix. Do I strip it?+

Yes. The API expects raw Base64 in templateFileData. Strip any data:...;base64, prefix before posting. Same applies to documentDataFile.

What extension should the response file have?+

Match outputType: .pdf for PDF, .docx for Docx, .html for HTML.

Generate Documents (Multiple)

Same template engine but produces many documents in one call from a JSON array or repeating XML records.

Fill a PDF Form

Populate existing AcroForm fields in a PDF with a stringified dataArray. Different engine, similar payload shape.

Protect Document

Apply password protection after generation. Common chained step before delivery.