Skip to main content

Get Document from PDF4me in n8n

Get Document From Pdf4me is a PDF4me node action in n8n that retrieves a document PDF4me already holds. Use it to collect the result of an earlier processing step, pull a stored file back into a later workflow run, or finish a callback-based job by fetching what was produced.

What this node does

PDF4me: Get Document From Pdf4me is a retrieval utility, not a transformation. It takes just two inputs, a File Name and a Callback URL, and both are required. It returns the stored file unchanged along with its name, size, and MIME type, so anything you need done to the document happens in a separate action chained after it.

Related Blog Posts
No blog post yet for this feature — coming soon.
In the meantime, browse the PDF4me blog for tutorials and workflows across every platform.
Visit the blog

Authenticating Your API Request

Every PDF4me node in n8n requires a valid Credential to connect with. Create or select one that holds your PDF4me API key so the workflow can authenticate retrieval requests securely.

Important Facts You Should Not Miss

Both fields are genuinely required
File Name and Callback URL each show a validation warning while empty. Unlike most PDF4me nodes there is no optional input to fall back on, so the node will not run until both are set.
It retrieves, it does not transform
The file comes back as stored, with its original MIME type reported. Converting, compressing, or securing it is a separate action placed after this one.
The file name must match exactly
Carry the name forward from the producing step with an expression. Retyping it by hand is the most common reason a retrieval finds nothing.
The PDF4me node in n8n with Action set to Get Document From Pdf4me, showing only two input fields, File Name and Callback URL, both marked with required validation warnings

The whole panel is four fields. The red borders on File Name and Callback URL are the node telling you both must be filled in before it will execute.

Retrieval vs Processing Actions

QuestionGet Document From Pdf4meA processing action
What it needsA file name and a callback URLA source file plus operation settings
What it changesNothing, the file is returned as storedThe document content or format
Where it sitsAfter the work, to collect the resultIn the middle, doing the work
What comes backThe stored file plus its metadataA newly produced document
Typical useFinishing a callback-based jobConverting, securing, or editing

What Parameters Does Get Document From Pdf4me Need?

ParameterRequiredWhat it doesExample
Credential to connect withRequiredThe PDF4me account credential the node authenticates with.PDF4ME account
ActionRequiredThe action this node performs. Select Get Document From Pdf4me.Get Document From Pdf4me
File NameRequiredExact name of the document to retrieve, including its extension. Best supplied by an expression carrying the name from the producing step.document.pdf
Callback URLRequiredReachable URL used for callback-based retrieval. The node shows a validation warning until it is set.https://example.com/callback

This node has an unusually small surface. There is no input-type selector, no output naming field, and no advanced options collection, which is why every parameter above is marked required rather than conditional.

Output

FieldTypeWhat it contains
successBooleanWhether the retrieval request completed. Branch on this before using the file.
messageStringHuman-readable status text, including error detail when something went wrong.
fileNameStringName of the retrieved document.
mimeTypeStringContent type of the retrieved file, which tells you what you actually got back.
fileSizeNumberSize of the retrieved document in bytes.
docNameStringDocument name reference, matching fileName.
retrievalCompletedBooleanConfirmation that retrieval finished. Worth checking alongside success.

The document itself is returned as binary data alongside these fields, ready to write to storage, attach to an email, or pass into another PDF4me action.

How Do I Set Up Get Document From Pdf4me in n8n?

  1. Add the PDF4me node to your workflow and set Action to Get Document From Pdf4me.
  2. Select your PDF4me credential, or create one and paste your API key.
  3. Set File Name to the exact stored name, ideally through an expression that carries it from the earlier step.
  4. Set Callback URL to a reachable endpoint. The node will not execute while it is empty.
  5. Execute the node.
  6. Check success and retrievalCompleted in the response with an IF node.
  7. Confirm mimeType matches what you expect before handing the file to a step that assumes a format.
  8. Route the binary document to storage, email, or the next PDF4me action.

Typical Setups

Workflow ExamplesCommon n8n workflow patterns using Get Document From Pdf4me.
Collect the result of a long job
  1. An earlier action starts work on a large document.
  2. Get Document From Pdf4me collects the finished file by name.
  3. The workflow continues without holding a connection open.
Fetch then transform
  1. The stored file is retrieved unchanged.
  2. A second PDF4me action compresses or secures it.
  3. Retrieval and processing stay cleanly separated.
Re-send on request
  1. A recipient asks for a document that was generated earlier.
  2. The workflow retrieves it by its stored name.
  3. It is emailed again without regenerating anything.
Guard the handoff
  1. An IF node checks success and retrievalCompleted.
  2. mimeType is compared against what the next step expects.
  3. A mismatch alerts instead of failing deeper in the chain.

Practical Tips

Pass the file name by expression
Carrying the name from the step that produced the document removes the single most common source of failed retrievals.
Check both success flags
success and retrievalCompleted are separate fields. Testing both is cheap and catches partial outcomes.
Use a reachable callback URL
The field is required and the value should be an endpoint that genuinely accepts requests, not a placeholder left in from testing.
Verify mimeType before assuming a format
A downstream PDF step that receives something else will fail confusingly. One comparison up front avoids that.
Do not expect transformation here
If the retrieved file needs changing, chain the relevant action after this one rather than looking for settings this node does not have.
Keep names unique and predictable
Retrieval is by exact name, so a naming convention set at generation time makes this node trivial to wire up later.

Cheat Sheet

FieldValue
ActionGet Document From Pdf4me
File Namedocument.pdf
Callback URLhttps://example.com/callback
CredentialsPDF4ME account
Success checksuccess and retrievalCompleted
Format checkmimeType

Common Questions

What does Get Document From Pdf4me actually do?+
It fetches a document that PDF4me already holds rather than transforming anything. It is a retrieval utility, so it belongs at the point in a workflow where a file produced earlier needs collecting, not where a document is created or converted.
Why does the node require a callback URL?+
The action is built around callback-based retrieval, the pattern where a longer running request reports completion to an endpoint instead of holding a connection open. Both File Name and Callback URL are marked required in the node panel, so nothing runs until a reachable URL is supplied. n8n can host such an endpoint through a Webhook node.
What file name should I enter?+
The exact name of the document as it was stored, including the extension. A near miss does not resolve to a different file, it simply finds nothing. Carry the name forward from the earlier step with an expression rather than retyping it.
How do I confirm the retrieval worked?+
The response returns a success boolean and a retrievalCompleted flag, alongside fileName, fileSize, and mimeType. Branch on those before using the file so a failed retrieval raises an alert instead of passing an empty item down the chain.
Does this node convert or modify the document?+
No. It returns the stored file as it is, with its original content type reported in mimeType, following the standard MIME type conventions. If the document needs converting, compressing, or securing, chain the relevant PDF4me action after this one.

Same Task on Other Platforms

Get Help