Add Image Stamp to PDF using n8n action

PDF4me Add Image Stamp to PDF adds custom image stamps and watermarks to PDF documents through n8n automation workflows. Process PDFs via n8n triggers, binary data, base64 strings, or public URLs to insert images (logos, signatures, seals, watermarks) with precise positioning, customizable sizing, transparency control, rotation angles, page-specific targeting, and flexible alignment options. This solution is ideal for document branding, confidential document marking, watermarking, logo placement, security stamps, and automated document enhancement workflows that require professional image integration with accurate rendering and seamless integration.

Setup

Add the PDF4me "Add Image Stamp to PDF" node to your n8n workflow and configure the required parameters. For initial setup instructions, see our n8n Integration Guide.

Prerequisites:

• PDF4me API credentials
• n8n workflow access

Get Your API Key

Configuration:

1. Add PDF4me node to workflow
2. Select "Add Image Stamp to PDF" action
3. Configure input parameters (see below)

Parameters

Complete list of parameters for the Add Image Stamp to PDF action. Configure these parameters to control image stamp addition.

Important: Parameters marked with an asterisk (***) are required and must be provided for the action to function correctly.

Parameter	Type	Description	Example
Input Data Type***	String	PDF Input Format Selection • Choose the format of your PDF data input • PDF4me supports multiple input types • Options: Binary Data, Base64 String, or URL	Binary Data
Input Binary Field	Binary	Binary PDF File Input (Required if Binary Data) • Reference PDF file from previous n8n node or file upload • PDF4me processes binary PDF files with automatic format detection • Required when Input Data Type is "Binary Data"	{{ $binary.data }}
Base64 Document Content	String	Base64 Encoded PDF Input (Required if Base64 String) • Provide PDF data as base64 encoded string • PDF4me automatically decodes and processes the PDF content • Required when Input Data Type is "Base64 String"	UEsDBBQABgAI...
File URL	String	Public PDF URL Input (Required if URL) • Provide a public/open permission URL to the PDF file • PDF4me downloads and processes the file from URL • Required when Input Data Type is "URL"	https://abc.com/sample.pdf
Image File Content***	Base64	Base64 Encoded Image Input • Provide image data (.png, .jpeg) as base64 encoded string • PDF4me decodes and processes with advanced compression • Essential for professional document stamping workflows	/9j/4AAQSk...
Image File Name***	String	Image Stamp Filename • Specify the name of the image file • Must include proper extension (.png or .jpeg) • PDF4me validates file format compliance	stamp.png
Align Horizontal***	String	Horizontal Alignment • Choose horizontal positioning on the page • Options: Left, Center, Right • PDF4me ensures precise alignment • Essential for professional presentation	Center
Align Vertical***	String	Vertical Alignment • Choose vertical positioning on the page • Options: Top, Middle, Bottom • PDF4me provides pixel-perfect positioning • Essential for consistent branding	Middle
Pages***	String	Page Specification • Define which pages should have the image stamp • Supports: single pages (0,1,2), ranges (2-5), mixed (1,2,3-7), open (2-) • If not specified, processes all pages • Examples: "0,1,2" or "2-5" or "1,2,3-7" or "2-"	0,1,2 or 2-5
Margin Horizontal In mm***	String	Horizontal Margin in Millimeters • Set the horizontal margin in millimeters • Applied on both left and right sides • Precise millimeter-based positioning • Essential for print-ready output	20
Margin Vertical In mm***	String	Vertical Margin in Millimeters • Set the vertical margin in millimeters • Applied above and below the image stamp • Ensures consistent vertical spacing • Essential for professional appearance	20
Margin Horizontal In px***	String	Horizontal Margin in Pixels • Set the horizontal margin in pixels • Defines space on left and right sides • Pixel-perfect positioning for digital workflows • Alternative to millimeter-based	10
Margin Vertical In px***	String	Vertical Margin in Pixels • Set the vertical margin in pixels • Defines space on top and bottom sides • Pixel-level precision for digital documents • Alternative to millimeter-based	10
Opacity***	String	Stamp Transparency Control • Set opacity level from 0 to 100 • 0 = entirely transparent, 100 = full opacity • Creates watermark effects and layered elements • Essential for professional visual impact	100
Height in mm***	String	Image Height in Millimeters • Set image height in millimeters • If set to 0, uses default or maintains aspect ratio • Precise sizing for print-ready documents • Essential for professional standards	60
Width in mm***	String	Image Width in Millimeters • Set image width in millimeters • If set to 0, uses default or maintains aspect ratio • Accurate dimensioning for consistent branding • Essential for print formats	60
Height in px***	String	Image Height in Pixels • Set height in pixels for digital positioning • Pixel-perfect height control • For web-based document workflows • Alternative to millimeter-based	60
Width in px***	String	Image Width in Pixels • Set width in pixels for digital sizing • Pixel-perfect width control • For screen-optimized documents • Alternative to millimeter-based	60
isBackground***	Boolean	Background Layer Control • Indicate whether stamp should be in background (true) or foreground (false) • Advanced layer management for watermarks • Creates professional visual hierarchy • Essential for stamp positioning	true
showOnlyInPrint***	Boolean	Print Visibility Control • Determine if stamp visible only in printed/exported versions (true) • Advanced visibility control for print-only watermarks • Creates screen-optimized document presentation • Useful for confidential stamps	false
Output File Name***	String	Enhanced PDF Output Filename • Specify the name for the generated PDF file • Must include .pdf extension • PDF4me ensures unique naming and format validation	document_with_image_stamp.pdf
Document Name***	String	Source PDF Reference • Specify the name of the source PDF file • For reference and tracking purposes • Helps with processing tracking	document.pdf
Debug Mode	Boolean	Debugging Control • Enable detailed logging and debugging information • Useful for troubleshooting image stamp issues • Default is false	false
Binary Data Output Name***	String	Binary Data Output Mapping • Define the variable name for accessing generated PDF binary data • Used in subsequent workflow actions • Essential for workflow automation	data

Supported Image Formats

Format	Description	File Extensions	Max Size	Use Cases
PNG	Portable Network Graphics with advanced transparency support and lossless compression	.png	50MB	Watermarks, logos, stamps with transparency, professional branding
JPEG	Joint Photographic Experts Group with optimized compression for photographic content	.jpg, .jpeg	50MB	Photographic stamps, detailed images, high-quality document branding

Output

Output Parameters

Parameter	Type	Description	Example
fileName	String	PDF4me generated PDF filename - The complete filename of the successfully generated PDF document with proper .pdf extension. PDF4me ensures unique naming and validates file format compliance for seamless integration with downstream processes	document_with_image_stamp.pdf
fileSize	Number	PDF4me PDF file size in bytes - The exact size of the generated PDF file in bytes, provided by PDF4me for storage planning, bandwidth optimization, and file transfer monitoring. Essential for enterprise document management and workflow automation	125430
success	Boolean	PDF4me image stamp status indicator - Boolean flag indicating the success or failure of the image stamp addition process. PDF4me returns true for successful operations and false for any errors, enabling robust error handling in automated workflows	true
mimeType	String	PDF4me output MIME type - MIME type of the generated PDF file, always "application/pdf" for PDF documents. Useful for content type validation and proper file handling in web applications	application/pdf
message	String	PDF4me image stamp status message - Human-readable status message providing details about the image stamp addition process result. Includes success confirmation or error details for troubleshooting	Image stamp added to PDF successfully

N8N Action Response

The PDF4me Add Image Stamp to PDF API returns a response that can be viewed in multiple formats. Choose the view that best fits your needs:

JSON

JSON Response Format

The raw JSON response from the API:

[
  {
    "success": true,
    "message": "Image stamp added to PDF successfully",
    "fileName": "document_with_image_stamp.pdf",
    "mimeType": "application/pdf",
    "fileSize": 125430
  }
]

Table

Table View

Response data in a structured table format:

Parameter	Value
success	true
message	Image stamp added to PDF successfully
fileName	document_with_image_stamp.pdf
mimeType	application/pdf
fileSize	125430

Schema

Schema View

The data structure and types of the response:

1 item
success: ☑ true
message: AB Image stamp added to PDF successfully
fileName: AB document_with_image_stamp.pdf
mimeType: AB application/pdf
fileSize: # 125430

Type Indicators:

• AB = String
• # = Number
• ☑ = Boolean

Binary

Binary Data View

The actual PDF file data and metadata:

data
─────────────────────────────
File Name: document_with_image_stamp.pdf
File Extension: pdf
Mime Type: application/pdf
File Size: 122.5 KB

Binary Data Access:

• n8n Binary Object: $binary.data.data
• Base64 Content: Available for direct use
• File Operations: Ready for download, email, or storage

Use Cases

Document Branding and Corporate Identity

• Add company logos, watermarks, and branding elements to PDF documents for corporate identity, brand consistency, and professional appearance
• Process business documents, reports, and presentations by adding branded stamps to ensure consistent corporate identity and professional presentation
• Transform client documents, proposals, and marketing materials by adding company logos and branding elements for brand recognition and professional credibility

Document Security and Authentication

• Add security stamps, authentication marks, and verification logos to PDF documents for document security, authenticity verification, and fraud prevention
• Process legal documents, contracts, and official records by adding security stamps to ensure document integrity and prevent unauthorized modifications
• Transform sensitive documents, confidential reports, and classified materials by adding security stamps for access control and document protection

Document Status and Workflow Management

• Add status stamps, approval marks, and workflow indicators to PDF documents for process tracking, approval workflows, and document management
• Process invoices, purchase orders, and business documents by adding status stamps to indicate processing stages, approvals, and workflow progress
• Transform project documents, reports, and deliverables by adding status stamps for project management, progress tracking, and stakeholder communication

Get Help

n8n Integration Guiden8n SampleGetting Started