Prerequisites
Before you begin, make sure you have:- A pdf noodle account (sign up here)
- Your API key from API Settings
- At least one template created in pdf noodle
- n8n installed (cloud or self-hosted)
Setting Up the Integration
n8n connects to pdf noodle using the HTTP Request node.Create a New Workflow
In n8n, create a new workflow and add your trigger (e.g., Webhook, Schedule, or any app trigger).
Configure the Request
Set up the HTTP Request node:
| Setting | Value |
|---|---|
| Method | POST |
| URL | https://api.pdfnoodle.com/v1/pdf/sync |
| Authentication | Predefined Credential Type → Header Auth |
Set Up Authentication
Create a Header Auth credential:
| Setting | Value |
|---|---|
| Name | Authorization |
| Value | Bearer YOUR_API_KEY |
Finding Your Template ID
- Go to app.pdfnoodle.com
- Navigate to the Templates section
- Copy the Template ID shown in the list next to your template
Response
When the request succeeds, you’ll receive:signedUrl in subsequent nodes to send via email, upload to storage, or attach to records.
Example Workflow
A typical workflow that generates an invoice when a new order is received:- Webhook Trigger - Receives order data
- HTTP Request - Generates the PDF with pdf noodle
- Send Email - Sends the PDF to the customer using
{{ $json.signedUrl }}
Error Handling
401 Unauthorized
401 Unauthorized
400 Bad Request
400 Bad Request
- Check your JSON syntax is valid
- Ensure all required template variables are provided
- Verify the template ID exists
Template Not Found
Template Not Found
- Double-check the Template ID
- Ensure the template exists in your pdf noodle account
API Endpoints
| Endpoint | Description |
|---|---|
POST /v1/pdf/sync | Generate PDF from template (synchronous) |
POST /v1/pdf/async | Generate PDF from template (asynchronous) |
POST /v1/html-to-pdf/sync | Convert HTML to PDF (synchronous) |
See the complete API Reference for all endpoints and options.
You can also generate PDFs using any HTTP Request node by calling the pdf noodle API directly. See the API Reference for all available endpoints and options.
Resources
- n8n Integration Page - pdf noodle + n8n overview
- n8n Automation Guide - Step-by-step tutorial
- n8n Documentation - Official n8n docs
- pdf noodle API Reference - Full API documentation