Automated Professional Image Watermarking Generator using JsonCut - n8n Workflow

E-commerce store managers requiring automated product image watermarking.
Photographers who need a quick and consistent way to protect their work.
Developers looking for advanced image processing n8n templates.
Users seeking robust API polling and complex flow control within an n8n workflow.

Creating high-quality, uniformly watermarked images is essential for protecting digital assets, yet manual processing can be time-consuming. This specialized n8n workflow transforms this task into a seamless automation by integrating the n8n trigger node with the powerful JsonCut API. The primary value of this solution is providing a complete end-to-end process, from parallel file uploads and data aggregation to complex API job definition and status polling. This n8n workflow is a perfect example of how to handle asynchronous API tasks using the Wait n8n node and If logic, offering reliable image generation and download capability.

This automation begins with the Form Trigger n8n trigger, which presents a public web form allowing users to upload their main image and a separate watermark image.

1. Parallel Uploads: The n8n workflow simultaneously uses two separate HTTP Request n8n node steps (Upload Main Image and Upload Watermark) to quickly send both binary files to the JsonCut API file storage.


2. Data Preparation: The Merge Uploads and Aggregate n8n node steps consolidate the two resulting storage URLs from the parallel streams into a single item, ready for the main API call.


3. Job Initiation: The Create JsonCut Job n8n node sends a POST request detailing the image composition job (main image as layer 1, watermark as layer 2, configured for 50% opacity and positioned at the bottom right).


4. Polling Loop: Because image processing is asynchronous, the n8n workflow enters a polling loop. It first pauses for 3 seconds using the Wait n8n node.


5. Status Check: The Check JsonCut job Status n8n node retrieves the current status of the job using the Job ID returned in step 3.


6. Conditional Flow: The If Success n8n node checks if the status is "COMPLETED". If it is, the n8n workflow proceeds to the final download. If not, the If Error n8n node checks for permanent failure (FAILED/CANCELLED). If the job is still pending, the n8n workflow loops back to the Wait n8n node to try again.


7. Final Download: Upon successful completion, the Download Image n8n node uses the final outputFileId to download the generated watermarked image binary.

1. Import Workflow: Copy the provided n8n workflow JSON data and paste it into your n8n instance using the 'New' > 'Import from JSON' function.


2. API Credentials: This n8n workflow requires a JsonCut API Key. You must set up HTTP Header Authentication credentials. Edit any of the JsonCut HTTP Request n8n node steps (e.g., Upload Main Image). Under the Authentication settings, select 'Generic Credential Type', choose 'HTTP Header Auth', and configure your API key as required by the JsonCut service.


3. Testing: Save and activate the n8n workflow. You can test the process by visiting the URL provided by the Form Trigger n8n trigger node, which allows direct file upload and execution of the n8n workflow.

Form Trigger n8n trigger: Acts as the entry point, capturing file inputs (Main Image and Watermark Image) from a custom web interface.
Upload Main Image / Upload Watermark n8n node (HTTP Request): Configured to send binary data using multipart-form-data to JsonCut's file upload API. Crucially, they run in parallel before merging.
Aggregate n8n node: Merges the separate output items from the parallel uploads, specifically combining the two unique storageUrl values needed for the composite image job definition.
Create JsonCut Job n8n node (HTTP Request): Sends the core image processing payload (JSON body) to define the watermarking layers, position (bottom right using percentages), size, and opacity (0.5).
Wait n8n node: An essential flow control n8n node that enforces a 3-second delay, managing the polling frequency to ensure the n8n workflow doesn't overwhelm the API while waiting for processing.
Check JsonCut job Status n8n node (HTTP Request): Polls the job status endpoint using expressions to dynamically insert the Job ID ({{ $json.data.jobId }}), driving the loop condition.
If Success / If Error n8n node: Provides necessary branching logic. If Success proceeds on "COMPLETED" status; If Error directs permanent failures to the Error Stop n8n node while looping back pending jobs to the Wait n8n node.
Download Image n8n node (HTTP Request): The final action in this n8n workflow. Configured to download the resulting image file binary using the dynamically obtained outputFileId from the successful status check.