
CLOUDINARY n8n INTEGRATION: AUTOMATE CLOUDINARY WITH N8N
CLOUDINARY N8N INTEGRATION: AUTOMATE CLOUDINARY WITH N8N
Need help automating Cloudinary with n8n?
Our team will get back to you in minutes.
Why automate Cloudinary with n8n?
The Cloudinary n8n integration gives you access to 6 actions covering the essential operations for media asset management: uploading assets from files or URLs, managing tags, retrieving metadata fields, and updating structured metadata. This means you can build complete asset pipelines that run on autopilot.
Significant time savings stand out as the primary benefit. No more manually uploading batches of images one by one. No more logging into the Cloudinary dashboard to update tags on dozens of assets. Set up smart rules that handle these tasks automatically—upload a file to a specific folder, and n8n takes care of pushing it to Cloudinary with the right tags and metadata instantly. Seamless integration with n8n's 400+ other app connectors means Cloudinary becomes part of your larger automation ecosystem. Pull images from Google Drive, process them through Cloudinary, and push the optimized versions to your CMS—all in one workflow.
Here's what you can build with the Cloudinary n8n integration:
- Automated content pipelines: Trigger uploads whenever new files appear in cloud storage
- Bulk tag management: Update tags across multiple assets based on external data sources
- Metadata synchronization: Keep Cloudinary metadata in sync with your PIM or DAM systems
- Asset processing workflows: Upload from URLs scraped from websites or received via webhooks
How to connect Cloudinary to n8n?
! 1 stepHow to connect Cloudinary to n8n?
- 01
Add the node
Search and add the node in your workflow.
TIP💡 TIP: Create a dedicated API key specifically for n8n automations rather than using your main account key. This way, you can revoke access if needed without disrupting other integrations, and you'll have clearer audit trails in your Cloudinary usage reports.- 01
Need help automating Cloudinary with n8n?
Our team will get back to you in minutes.
Cloudinary actions available in n8n
01 Action 01Get Metadata Fields
The "Get Metadata Fields" action retrieves all metadata field definitions configured in your Cloudinary account. This is particularly useful when you need to understand what structured metadata options are available before updating assets programmatically, or when building dynamic workflows that adapt to your metadata schema.
Key parameters:
- Credential to connect with: Select your Cloudinary account credentials from the dropdown. This is required for authentication.
- Resource: Choose the resource type to interact with—typically set to "Admin" for metadata operations. This is a required dropdown selection.
- Operation: Specifies the action to perform, fixed to "Get Metadata Fields" in this context. Required.
Use cases:
- Fetch available metadata fields before running bulk update operations
- Validate that required custom fields exist in your Cloudinary setup
- Build dynamic forms in other applications based on your Cloudinary metadata schema
When to use it: Run this action at the start of complex workflows to ensure your metadata structure matches expectations, or use it periodically to sync field definitions with external systems.

02 Action 02Get Tags
The "Get Tags" action retrieves all tags associated with resources in your Cloudinary account. It's essential for auditing your tag taxonomy, finding specific tagged assets, or synchronizing tag data with external systems like your CMS or e-commerce platform.
Key parameters:
- Credential to connect with: Your Cloudinary account credentials. Required dropdown selection.
- Resource: The specific resource category from which to fetch tags. Required.
- Resource Type: Specifies the asset type (e.g., Image, Video). Required dropdown.
- Prefix: Filter tags that start with a specific string. This is optional and accepts text input—great for organizing tags by category (e.g., "product_", "campaign_").
- Max Results: Numeric field setting the maximum number of tags to return, defaulting to 100. Optional.
Use cases:
- Export your complete tag list to a spreadsheet for review
- Find all tags matching a specific naming convention
- Sync tag taxonomies between Cloudinary and your product database
When to use it: Perfect for tag audits, building tag-based navigation in your applications, or cleaning up unused tags.

03 Action 03Update Asset Tags
The "Update Asset Tags" action modifies the tags associated with a specific asset in Cloudinary. Use this when you need to categorize, organize, or update the discoverability of your media assets based on external events or data.
Key parameters:
- Credential to connect with: Cloudinary account for authentication. Required dropdown.
- Resource: Fixed to "Update Asset" for this operation. Required.
- Operation: Set to "Update Asset Tags." Required.
- Public ID: The unique identifier of the asset you want to update. Required text field—this is how Cloudinary identifies the specific file.
- Resource Type: The type of asset (Image, Video, Raw). Required dropdown.
- Type: Typically set to "Upload" for uploaded assets. Required.
- Tags: The tags to associate with the asset. Required text input—you can specify multiple tags.
- Update Fields: Optional section for additional configuration.
Use cases:
- Automatically tag new product images with category data from your e-commerce platform
- Add campaign tags to assets when they're selected for marketing materials
- Remove outdated tags when products are discontinued

04 Action 04Update Asset Structured Metadata
The "Update Asset Structured Metadata" action allows you to modify custom metadata fields on your Cloudinary assets. Structured metadata is more powerful than tags—it supports defined field types, validation, and complex data organization.
Key parameters:
- Credential to connect with: Your Cloudinary credentials. Required.
- Resource: Fixed to "Update Asset." Required.
- Operation: Set to "Update Asset Structured Metadata." Required.
- Public ID: Unique asset identifier. Required text input.
- Resource Type: Asset type (Image, Video, etc.). Required dropdown.
- Type: Action type, typically "Upload." Required.
- Structured Metadata: The metadata to update in JSON-like format. Required text input.
- Update Fields: Optional fields for specifying which metadata properties to update.
Use cases:
- Sync product information (SKU, price, description) from your PIM to image metadata
- Update copyright and licensing information across asset libraries
- Store AI-generated image descriptions as structured metadata

05 Action 05Upload an Asset from File
This action uploads a file directly to your Cloudinary account. It's the foundation of any automated media pipeline where files originate from your server, another node in n8n, or binary data from previous workflow steps.
Key parameters:
- Credential to connect with: Cloudinary authentication. Required dropdown.
- Resource: Fixed to "Upload." Required.
- Operation: Set to "Upload File." Required.
- File: The file data to upload. Required text input—typically connected to binary data from a previous node.
- Resource Type: Type of file being uploaded (Image, Video, Raw). Required dropdown.
- Additional Fields: Optional section to add extra properties like folder path, tags, or transformations.
Use cases:
- Automatically upload screenshots captured by monitoring tools
- Push user-uploaded images from your app to Cloudinary for processing
- Migrate assets from local storage to Cloudinary in bulk

06 Action 06Upload an Asset from URL
The "Upload from URL" action fetches a file from any publicly accessible URL and uploads it to your Cloudinary account. This is incredibly powerful for scraping images, processing external content, or building aggregation workflows.
Key parameters:
- Credential to connect with: Your Cloudinary credentials. Required.
- Resource: Fixed to "Upload." Required.
- Operation: Set to "Upload From URL." Required.
- URL: The direct URL of the asset to upload. Required text input—must be a valid, accessible link.
- Resource Type: The type of asset (Image, Video, etc.). Required dropdown.
- Additional Fields: Optional section for specifying folder, tags, public ID, or transformations.
Use cases:
- Import product images from supplier feeds via URL
- Archive social media images by uploading them to Cloudinary
- Build a web scraper that saves images to your media library automatically

Build your first workflow with our team
Drop your email and we'll send you the catalog of automations you can ship today.
- Free n8n & Make scenarios to import
- Step-by-step setup docs
- Live cohort + community support
Frequently asked questions
Is the Cloudinary n8n integration free?
The n8n integration itself is free to use—n8n is open-source and you can self-host it at no cost. However, Cloudinary operates on a freemium model. You get a generous free tier with 25 credits per month (roughly 25GB of storage or 25GB of bandwidth), which is plenty for testing and small projects. If your automation workflows handle significant media volumes, you'll likely need a paid Cloudinary plan. The good news is that n8n's efficiency means you're only making API calls when necessary, helping you stay within your limits.What types of files can I upload to Cloudinary through n8n?
Through the n8n integration, you can upload images (JPEG, PNG, GIF, WebP, SVG, and more), videos (MP4, MOV, AVI, WebM, etc.), and raw files (PDFs, documents, any binary file). The "Resource Type" parameter in the upload actions lets you specify what kind of asset you're uploading. Cloudinary automatically handles format detection in most cases, but explicitly setting the resource type ensures proper processing and transformation capabilities. For images, Cloudinary supports over 60 formats; for video, it handles all major codecs.How long does it take to set up the Cloudinary n8n integration?
You can have a working Cloudinary n8n connection in under 5 minutes. The setup is straightforward: grab your API credentials from the Cloudinary dashboard (they're displayed right on the main page), create a new credential in n8n, paste in the values, and you're done. Building your first workflow might take another 10-15 minutes depending on complexity. The Cloudinary node in n8n is well-documented with clear parameter descriptions, so even first-time users can get productive quickly without deep technical knowledge.


