Overview
This node integrates with CloudConvert to create and manage file conversion jobs. It allows users to define complex conversion workflows using JSON job definitions, upload input files as binary data, and optionally wait synchronously for job completion to download results. It supports tagging jobs, synchronous or asynchronous execution, and webhook notifications for job completion. This node is useful for automating file format conversions, batch processing, and integrating CloudConvert's API into workflows.
Use Case Examples
- Convert multiple files from one format to another by defining a job with import, conversion, and export tasks in JSON, then execute the job and download the results synchronously.
- Create a job with a custom tag and receive webhook notifications upon job completion for asynchronous processing.
- Upload binary files from input items to CloudConvert automatically and use them as inputs in the conversion job.
Properties
| Name | Meaning |
|---|---|
| Job Definition (JSON) | The full JSON definition of the conversion job, specifying tasks and workflow. |
| Tag | Custom tag to add to the job for identification or filtering. |
| Synchronous Call? | Whether to send the request synchronously and wait for job completion. |
| Download? | Whether to download result files from a synchronous request and add them as binary attachments. |
| Upload Input Binaries? | Whether to upload any binary attachments from input items as import/base64 tasks automatically. |
| Webhook URL | Webhook URL to invoke on job completion, used only for asynchronous jobs. |
Output
Binary
Binary output contains downloaded result files from export/url tasks when synchronous execution with download option is enabled.
JSON
id- Unique identifier of the created job.status- Current status of the job (e.g., processing, finished).tag- Custom tag assigned to the job.tasks- Details of tasks defined and executed in the job.created_at- Timestamp when the job was created.
Dependencies
- CloudConvert API
Troubleshooting
- Ensure the JSON job definition is valid and correctly formatted to avoid API errors.
- Synchronous calls for heavy jobs may time out or be slow; use asynchronous calls with webhooks instead.
- When using the download option, only export tasks of type export/url are supported for automatic binary attachment retrieval.
- If uploading input binaries, ensure input items contain valid binary data properties.
Links
- CloudConvert Job Builder UI - Tool to construct and validate job definitions visually.
- CloudConvert n8n Node GitHub Repository - Source code and documentation for the CloudConvert n8n node.