Actions8
Overview
The node integrates with CloudConvert, a versatile file conversion and processing service. It enables users to perform various file operations such as converting files between formats, creating archives (e.g., ZIP or RAR), generating thumbnails, merging multiple files into one PDF, adding watermarks, optimizing/compressing files, extracting metadata, and capturing website screenshots or PDFs.
This node is beneficial in automation workflows where file manipulation is required without manual intervention. For example:
- Automatically converting uploaded documents to PDF.
- Creating an archive of multiple files before sending them via email.
- Generating image thumbnails for web galleries.
- Adding watermarks to images or PDFs for branding or copyright protection.
- Capturing a snapshot of a webpage for monitoring or archival purposes.
Properties
| Name | Meaning |
|---|---|
| Authentication | Method to authenticate with CloudConvert: "OAuth2 (Recommended)" or "API Key". |
| Operation | The action to perform: Create Archive (among others like convert, merge, watermark, etc.). |
| Output Format | The desired output format for the resulting file (e.g., zip, rar). |
| Binary Input Data | Whether the input file data should be taken from a binary field (true) or from text content (false). |
| Input File Content | The textual content of the file to upload (used if Binary Input Data is false). |
| Input Filename | The filename including extension for the input file (used if Binary Input Data is false). |
| Binary Property | The name of the binary property containing the file data to be processed (used if Binary Input Data is true). |
Output
The node outputs JSON data representing the result of the operation performed by CloudConvert. This typically includes information about the processed file(s), such as URLs to download the converted or archived files, metadata, or job status.
If the operation involves binary data (e.g., converted files), the node can output this binary data attached to the output item, allowing subsequent nodes to use or save the file.
Dependencies
- Requires access to the CloudConvert API.
- Requires user authentication via either OAuth2 or an API key credential configured in n8n.
- Network connectivity to CloudConvert's API endpoints.
- No additional environment variables are explicitly required beyond the credentials.
Troubleshooting
- Invalid operation error: If an unsupported operation is selected, the node throws an error indicating the invalid operation. Ensure the operation parameter is set correctly.
- Authentication failures: Errors related to authentication usually mean the provided API key or OAuth2 token is invalid or expired. Verify credentials in n8n settings.
- Missing input data: If the input file content or binary data is missing or incorrectly referenced, the node will fail. Confirm that the binary property name matches the actual binary data field or that text content and filename are provided when not using binary input.
- Output format issues: Selecting an unsupported output format for the chosen operation may cause errors. Use the node’s dynamic loading of output formats to select valid options.
- Network or API errors: Temporary network issues or API rate limits can cause failures. Retrying or checking CloudConvert service status may help.