npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

n8n-nodes-cloudconvert

v0.1.7

Published

A Node to send file conversion jobs to cloudconvert.com

Downloads

53

Readme

n8n-nodes-cloudconvert

logo

npm version

.github/workflows/publish-npm.yml

This is an n8n community node. It lets you use CloudConvert in your n8n workflows.

CloudConvert is an online service providing all sorts of file processing / transformation features, that can be used to convert or tweak PDFs, images, ebooks, audio, documents, etc...

n8n is a fair-code licensed workflow automation platform.

Installation
Operations
Credentials
Compatibility
Usage
Resources

Installation

Follow the installation guide in the n8n community nodes documentation.

Operations

Action Node

  • Jobs:
    • Create (sync or async, with file upload / download options)
    • List
    • Get One
    • Delete
  • Webhooks
    • List
    • Delete

Trigger Node

  • Receive webhook (with file download option)

Credentials

Authentication relies on an API key that you can generate from your CloudConvert dashboard. Both live and sandbox environments are supported. You will likely need the task.read and task.write scopes, but the Trigger node also requires the webhook.read and webhook.write scopes.

Note that sandbox credentials are separate from live credentials.

Compatibility

Tested on n8n 0.206.1

Usage

Sandbox Usage

Note that it's strongly recommended to perform your tests against the sandbox environment, which needs to be enabled first and which uses a separate API key. Note that:

  • Separate credentials should be created for the live and sandbox environments.
  • The main limitation of the sandbox environment is that all imported files need to be whitelisted first before processing (based on the file's md5 hash).

Job Definitions

The most useful operation is to send new conversion jobs to CloudConvert. The definition of each job is done in JSON format, and the CloudConvert Job Builder UI can be used to build the job definition visually and interactively, and copy-paste the resulting JSON.

Here's a sample workflow / node definition:

logo

logo

File Upload Support

When checked, in the Create Job operation, the Upload Input Binaries option will cause the following:

  • Binary attachments of any item sent to the node as input will be uploaded to CloudConvert as an import/base64 task.
  • The tasks will be named autoimport-<binary_name>, where <binary_name> is the property name holding the attachment
  • The tasks will be automatically added to the job definition, there's no need to specify them. However, you will still need to specify the task name as input to any following task that is expected to process that imported file.

File Download Support

In the Create Job operation (only if the call is made synchronously), as well as in the Trigger node, there is an option to automatically download any resulting file exported by the job upon completion. Note that:

  • Only the files generated by export/url tasks are supported
  • The files will be added as binary attachments to the node's output items. The name of the binary property will be <task_name>_<N> where:
    • <task_name> is the name of the export task
    • <N> is the sequence number - since an export task may output more than one file. This will most often be 0

Webhook Signature Verification

The Trigger node can optionally enforce signature verification on incoming calls. It will automatically fetch the signature key from the webhook definition in CloudConvert, and will use it to validate the signature sent in the webhook calls in the CloudConvert-Signature HTTP header, to ensure that the call is indeed being initiated from CloudConvert.

When enabled, incoming webhook calls failing validation will be silently ignored.

Resources

TODO

  • Improve logging?