n8n-nodes-uhuu

This is an n8n community node for the Uhuu API. It can generate documents from templates (with optional polling until ready) or retrieve an existing document by ID, and return the PDF as binary data.

Uhuu is a document automation platform. n8n is a workflow automation platform.

Installation

Follow the n8n community nodes installation guide.

Credentials

Create a new Uhuu API credential in n8n:

1. In Uhuu, go to Dashboard -> API Tokens and create a token. You can also open app.uhuu.io/team-tokens for direct access to active team tokens.
2. Ensure the token has these scopes: template.read, template.create, document.read
3. Paste the token into the credential.
4. Optional: override the base URL for self-hosted Uhuu deployments.

Credential test uses GET /team to verify your token.

Node: Uhuu

Choose an operation, then fill in the shown parameters.

Generate a Document

Creates a new document from a template.

Inputs:

• Template ID: The Uhuu template ID (e.g. 872).
• Payload (JSON): Optional. JSON data to merge into the template (default: {}).
• Wait for Completion: Whether to poll until the document is ready or error.
• Poll Interval (MS) / Timeout (MS): Shown when Wait for Completion is on.
• Return Binary: Whether to download the PDF and attach it as binary data.
• Binary Property: Name of the binary output field (when Return Binary is on).

Behavior:

• Sends POST /v1/templates/{templateId} with your JSON payload.
• If Wait for Completion is on, polls GET /v1/documents/{documentId} until ready or error.
• Output JSON is the API document object (id, status, url, pdf_url, thumbnail_url, etc.). When Return Binary is on, the PDF is downloaded from pdf_url when present, otherwise url.

Get a Document

Retrieves an existing document by ID.

Inputs:

• Document ID: The Uhuu document ID (from a previous Generate or the Uhuu API).
• Return Binary / Binary Property: Same as in Generate.

Behavior:

• Sends GET /v1/documents/{documentId}.
• Returns the same document JSON and optional binary as Generate.

Example Payload

{
  "title": "Pink Owl of the Whispering Woods",
  "message": "Once upon a time, deep in the heart of the Whispering Woods, there lived a magical creature known to few -- a pink owl with feathers as soft and vibrant as a sunset.",
  "url": "https://platform.uhuu.io/common/samples/pink-owls/pink-owl-2.jpeg"
}

Notes

• Uhuu document generation is asynchronous. Use Wait for Completion when you need the PDF in the same run.
• If Return Binary is on but the document is not ready, the node returns a clear message and suggests enabling Wait for Completion or using Get Document later.

Compatibility

Tested with n8n 1.x.

Resources

• Uhuu Developer Docs
• n8n community nodes