n8n

Welcome to the n8n Integration Guide! By leveraging our custom community node, you can seamlessly embed high-performance document and PDF generation directly into your node-based automation workflows.

Whether you are fetching database records, listening to incoming webhooks, or processing CRM updates, the ComposeIt node allows you to map data dynamically without writing complex API scripts.

---

Installation & Setup

Step 1: Install the Community Node

Before you can use ComposeIt inside your workflows, you need to add our community package to your n8n instance.

1. Log into your n8n instance and navigate to Settings > Community Nodes.
2. Click on Install a Community Node.
3. In the npm Package Name field, enter:

   n8n-nodes-composeit

4. Agree to the terms and click Install.

Once installed, open any workflow canvas, press Tab or click the + icon, and search for ComposeIt.

Step 2: Authenticate Your Account

Drag the ComposeIt node onto your canvas. To connect your account, click on the Credential dropdown and choose Create New Credential. Copy and paste your secret API Key generated from your ComposeIt developer dashboard.

Next, choose your primary operational action from the Resource and Operation selectors. You can choose to either update a layout blueprint or compile a finished document asset.

---

Operation 1: Update Template

This operation is ideal if you need to programmatically adjust baseline styles, layout parameters, or metadata fields on your template using upstream workflow variables.

1. Select your target template from the dynamic Template ID dropdown.
2. Define the properties you want to modify.
3. Click Test Step or execute the node and commit changes.

---

Operation 2: Generate Document

This operation merges raw context variables from your workflow into your styled visual layouts to deliver clean, production-grade assets.

1. Choose Output File Formats

Specify which file types you want ComposeIt to render. You can toggle multiple selections simultaneously if your pipeline requires alternative formats:

• PDF: High-fidelity, print-ready documents (Invoices, reports, certificates).
• Image: Compressed image formats (PNG/JPEG), perfect for real-time mobile push previews.
• HTML / MJML: Responsive layout codes designed for transactional email structures.

2. Configure Input Modes

ComposeIt adapts to your preferred working style. You can map your workflow properties using two distinct structural interfaces:

• Form Schema Mapping: ComposeIt reads your template's underlying variable configuration and builds dedicated user-interface fields automatically.
• Raw JSON Entry: Toggle this mode to pass a unified, multi-layered, nested JSON payload using standard n8n expression tags.

3. Map Fields and Run Execution

Bind properties directly from your previous workflow triggers (such as PostgreSQL rows, Airtable items, or Stripe events) to your designated template slots. Run a test execution to verify your variables populate seamlessly.

💡 Don't forget: Immediately add a Google Drive, Dropbox, or email step right after this action to save your generated PDF file before the 24-hour retention window closes!