Actions5
- Upload Actions
- Update Asset Actions
- Admin Actions
Overview
This node integrates with Cloudinary to upload and manage media assets. Specifically, the Upload From URL operation under the Upload resource allows users to upload an image, video, or raw file directly from a publicly accessible URL to their Cloudinary account.
Common scenarios where this node is beneficial include:
- Automatically importing images or videos hosted elsewhere on the web into your Cloudinary media library.
- Migrating assets from external sources without manual download/upload steps.
- Automating workflows that require fetching and storing media files by URL for further processing or delivery.
For example, you could use this node to upload product images from supplier URLs into your own Cloudinary account for consistent management and delivery.
Properties
| Name | Meaning |
|---|---|
| URL | The direct URL of the image, video, or raw file to upload to Cloudinary. |
| Resource Type | The type of asset being uploaded. Options: Image, Video, Raw. |
| Additional Fields | Optional extra parameters to customize the upload: |
| - Public ID: Custom identifier for the uploaded resource. | |
| - Folder: Folder path in Cloudinary where the asset will be stored. | |
| - Upload Preset: Name of a predefined upload preset configured in your Cloudinary account. |
Output
The node outputs JSON data representing the response from Cloudinary after the upload request completes. This includes details such as:
- The public ID assigned to the uploaded asset.
- URLs for accessing the uploaded media.
- Asset metadata like format, size, width, height, etc.
- Any transformation or versioning information.
If the upload is successful, the output JSON contains all relevant information about the newly created Cloudinary resource.
Dependencies
- Requires a valid Cloudinary account with API credentials (cloud name, API key, and API secret).
- The node uses these credentials to authenticate API requests.
- No additional environment variables are needed beyond the configured Cloudinary API credentials in n8n.
Troubleshooting
- Invalid URL or inaccessible resource: Ensure the provided URL is publicly accessible and points directly to a valid media file.
- Authentication errors: Verify that the Cloudinary API credentials are correctly set up and have sufficient permissions.
- Invalid additional fields: Check that optional fields like Public ID or Upload Preset are valid and exist in your Cloudinary account.
- API rate limits or network issues: If uploads fail intermittently, consider retrying or checking Cloudinary service status.
Common error messages may include:
"Invalid signature": Usually caused by incorrect API secret or malformed parameters."Resource not found": When the URL is invalid or the specified folder/preset does not exist."Unauthorized": Credentials are missing or incorrect.
Resolving these typically involves verifying credentials, URLs, and parameter correctness.