Ressources · Intégration n8n

Intégration CloudConvert n8nAutomatiser CloudConvert avec n8n.

Un devis à fusionner, un scan à rendre lisible, une photo trop lourde : ces gestes se répètent et personne ne devrait les faire à la main. L'intégration CloudConvert n8n regroupe 17 opérations sur 5 ressources dans un seul nœud. Pas de trigger côté CloudConvert : le workflow démarre toujours ailleurs.

Nœud communautaire Ce nœud n'est pas livré avec n8n : c'est un paquet communautaire (@cloudconvert/n8n-nodes-cloudconvert) à installer depuis Settings › Community nodes sur une instance auto-hébergée. npm

Tester l'intégration CloudConvert sur n8n Voir les 17 opérations

Avis vérifiés sur Trustpilot · Agence IA, automatisation & growth

Pourquoi automatiser

À quoi sert l'intégration CloudConvert n8n ?

CloudConvert transforme un fichier en un autre fichier : autre format, poids réduit, scan rendu cherchable, copie filigranée. Le nœud n8n expose cette API pour que le traitement se fasse entre deux étapes du workflow, sans téléchargement humain. Un nœud, 5 ressources (Command, File, Metadata, PDF, Website), 17 opérations, en version 1 du nœud.

Premier cas, la signature. Une affaire passe au statut gagné dans ClickUp, le workflow rassemble le devis, les conditions générales et l'annexe technique, puis pdf.pdf/merge en fait un seul document. Un passage par file.watermark ajoute la mention du statut et le client reçoit une pièce jointe au lieu de trois.

Deuxième cas, les scans fournisseurs. Les factures arrivent en photo dans la boîte lue par Gmail. pdf.pdf/ocr pose une couche de texte dessus, metadata.metadata récupère ce que le fichier déclare, et la ligne part dans Google Sheets avec le numéro de commande extrait du texte. Sans OCR, aucun nœud d'extraction ne lit quoi que ce soit.

Troisième cas, les pièces jointes trop lourdes. Un ticket ouvert dans Jira Software embarque des captures de plusieurs mégaoctets ; file.optimize les compresse et file.thumbnail fabrique l'aperçu affiché dans la liste. Le stockage cesse de gonfler tout seul.

Quand l'opération manque, le nœud HTTP Request appelle n'importe quel endpoint de l'API CloudConvert et réutilise le même credential via l'authentification prédéfinie. C'est la bonne porte de sortie, et elle garde les identifiants au même endroit. Le choix de la plateforme elle-même est traité dans l'Avis n8n.

Deux limites à connaître avant de construire. CloudConvert n'a pas de nœud trigger dans n8n : le workflow démarre avec un Schedule Trigger à intervalle fixe, un Webhook n8n appelé par un service tiers, ou le trigger d'un autre outil. Et le nœud étant communautaire, il s'installe sur une instance auto-hébergée ; n8n Cloud n'accepte que les nœuds communautaires vérifiés.

Connexion

Comment connecter CloudConvert à n8n ?

01
Installer le nœud communautaire
CloudConvert n'est pas livré avec n8n. Ouvre Settings, puis Community nodes, et installe le paquet npm @cloudconvert/n8n-nodes-cloudconvert (version 1.1.1). Ça fonctionne sur une instance auto-hébergée, que n8n tourne via Docker ou via npm. Sur n8n Cloud, l'offre hébergée par n8n, seuls les nœuds communautaires vérifiés passent. Une fois le paquet installé, CloudConvert apparaît dans la recherche de nœuds comme les autres.
02
Créer le credential
Dans le menu Credentials, ajoute un credential CloudConvert, c'est-à-dire le jeu d'identifiants que n8n conserve pour toi. Deux méthodes d'authentification existent : OAuth2 (Recommended), où CloudConvert remet un jeton à n8n après ton accord, et API Key, où tu colles une clé issue de ton compte CloudConvert. Le credential se crée une fois et se réutilise dans tous les workflows.
03
Le choisir dans le nœud et tester
Pose le nœud CloudConvert dans un workflow et sélectionne le credential dans sa liste déroulante. Choisis la ressource, puis l'opération, et pointe Binary Property sur le champ qui porte le fichier, souvent data en sortie du nœud précédent. Lance l'exécution sur un seul vrai fichier et regarde le binaire renvoyé avant de brancher la suite derrière.

Actions

Ce que le nœud CloudConvert sait faire

Le nœud CloudConvert expose 17 opérations sur 5 ressources. Pour chacune : le nœud tel que tu le configures dans n8n, les champs obligatoires, et nos notes de terrain.

Matrice ressources × opérations
Ressource	Create Archive	Capture Website	Execute Command	Convert File	Get Metadata	Write Metadata	Optimize File	Convert PDF to PDF/A	Decrypt PDF	Encrypt PDF	Extract Pages From PDF	Merge Files	Add PDF OCR Layer	Rotate PDF Pages	Split PDF Into Pages	Create Thumbnail	Add Watermark
Command			✓
File	✓			✓			✓									✓	✓
Metadata					✓	✓
PDF								✓	✓	✓	✓	✓	✓	✓	✓
Website		✓

Command

1 opération

Execute command

command.command

Ce que tu vois dans n8n

Notes & cas d'usage

Exécute une commande ffmpeg, ImageMagick ou GraphicsMagick sur le fichier d'entrée, ce qui couvre tout ce que les opérations prêtes à l'emploi ne font pas.

Paramètres clés

Command : la commande de base, par exemple ffmpeg ou convert ; la liste des commandes supportées est dans la doc CloudConvert.
Engine : FFmpeg, ImageMagick ou GraphicsMagick.
Arguments : les fichiers d'entrée se lisent dans /input/{taskName}/ et la sortie doit être écrite dans /output/.
Capture Console Output : renvoie la sortie console dans le résultat, seul moyen de comprendre une commande qui échoue.

Cas d'usage

réencoder un enregistrement de réunion pour qu'il se lise partout, avec la chaîne d'arguments écrite directement dans le nœud.

File

5 opérations

Add watermark to a file

file.watermark

Ce que tu vois dans n8n

Notes & cas d'usage

Appose un filigrane sur un PDF, une image ou une vidéo, et renvoie la copie marquée pendant que l'original reste intact.

Paramètres clés

Text : le texte du filigrane, souvent une expression du type {{ $json.state }}.
Font Size : requis, à tester sur le plus grand format de page que tu traites.
Image URL : une image PNG, JPG ou SVG à la place du texte, avec Watermark Image.
Opacity : un pourcentage, 100 signifiant totalement visible.
Vertical Position et Horizontal Position : haut, centre ou bas, et gauche, centre ou droite.

Cas d'usage

marquer chaque brouillon de contrat avant qu'il ne sorte, pour éviter la signature de la mauvaise version.

Convert a file

file.convert

Ce que tu vois dans n8n

Notes & cas d'usage

L'opération de base : un fichier entre, le même contenu ressort dans un autre format.

Paramètres clés

Output Format : le format de sortie, choisi dans la liste.
Input File Name : le nom du fichier avec son extension, c'est ainsi que CloudConvert sait ce qu'il reçoit.
Binary Property : le champ binaire qui porte le fichier à convertir.
Additional Options : un dictionnaire JSON d'options ajoutées à la tâche de conversion, que le job builder de CloudConvert génère pour toi.

Cas d'usage

un partenaire exporte ses tableaux dans le format de son outil, et le workflow ramène tout au même format avant lecture.

Create archive

file.archive

Ce que tu vois dans n8n

Notes & cas d'usage

Regroupe plusieurs fichiers dans une seule archive, pour que le workflow ne transporte qu'un item au lieu de huit.

Paramètres clés

Output Format : le format d'archive, ZIP, RAR ou un autre format supporté.
Input File Contents : le contenu texte envoyé quand le fichier n'est pas binaire.
Binary Input Data : coché, les fichiers sont pris dans un champ binaire.
Input File Name : le nom avec extension, qui devient l'entrée visible dans l'archive.

Cas d'usage

réunir les exports du mois dans une archive unique avant l'envoi, plutôt qu'une pièce jointe par fichier.

Create a thumbnail

file.thumbnail

Ce que tu vois dans n8n

Notes & cas d'usage

Fabrique une vignette du fichier, utile dès qu'une liste doit montrer quelque chose avant l'ouverture.

Paramètres clés

Width et Height : les dimensions de la vignette en pixels.
Fit : Max garde l'image dans le cadre sans agrandir une image plus petite, Crop remplit le cadre et coupe l'excédent, Scale impose les deux dimensions.
Output Format : le format d'image renvoyé.
Binary Property : le champ qui contient le fichier source.

Cas d'usage

générer une couverture par document déposé, pour qu'une page catalogue charge des aperçus au lieu de PDF entiers.

Optimize a file

file.optimize

Ce que tu vois dans n8n

Notes & cas d'usage

Compresse un fichier pour réduire son poids sans changer son format, ce qui compte dès que l'étape suivante a une limite de taille.

Paramètres clés

Binary Property : le champ binaire qui porte le fichier à compresser.
Binary Input Data : coché, le fichier vient de ce champ binaire ; décoché, CloudConvert lit Input File Contents.
Additional Options : un dictionnaire JSON d'options ajoutées à la tâche, généré avec le job builder de CloudConvert.

Cas d'usage

alléger les photos produit sorties d'un formulaire avant leur envoi vers un espace de stockage facturé au volume.

Metadata

2 opérations

Get metadata from a file

metadata.metadata

Ce que tu vois dans n8n

Notes & cas d'usage

Lit les métadonnées que CloudConvert sait extraire d'un fichier et les renvoie en JSON, pour que le nœud suivant puisse trancher dessus.

Paramètres clés

Input File Name : le nom du fichier, extension comprise.
Binary Property : le champ binaire contenant le fichier à inspecter.
Binary Input Data : à laisser coché quand le fichier arrive d'un nœud précédent plutôt qu'en texte.

Cas d'usage

classer les documents entrants d'après ce que le fichier déclare lui-même, et non d'après l'objet de l'email tapé par l'expéditeur.

Write metadata to a file

metadata.metadata/write

Ce que tu vois dans n8n

Notes & cas d'usage

Écrit des métadonnées dans le fichier et renvoie la copie mise à jour, l'exact miroir de la lecture.

Paramètres clés

Metadata : un dictionnaire JSON de clés et de valeurs à écrire, par exemple Title, Author, Creator ou Producer.
Input File Contents : le contenu texte quand le fichier est envoyé directement.
Binary Property : le champ qui porte le fichier à réécrire.

Cas d'usage

renseigner un vrai Title et un vrai Author sur chaque PDF produit par un workflow, pour que le document reste identifiable une fois sorti de n8n.

PDF

8 opérations

Add OCR layer to PDF

pdf.pdf/ocr

Ce que tu vois dans n8n

Notes & cas d'usage

Ajoute une couche de texte sur un PDF scanné, ce qui transforme une photo de page en document cherchable et copiable.

Paramètres clés

Languages : une liste de codes de langue séparés par des virgules, par exemple eng,deu.
Auto Orient : détecte et corrige l'orientation des pages avant la passe OCR.
Binary Property : le champ binaire qui contient le PDF scanné.

Cas d'usage

rendre cherchable une pile de bons de livraison scannés, pour qu'un nœud suivant y pêche le numéro de commande.

Convert PDF to PDF/A

pdf.pdf/a

Ce que tu vois dans n8n

Notes & cas d'usage

Réécrit un PDF dans la famille d'archivage PDF/A, celle que réclament en général les règles de conservation.

Paramètres clés

Conformance Level : PDF/A-1B, PDF/A-2B ou PDF/A-3B.
Binary Property : le champ qui porte le PDF à convertir.
Binary Input Data : coché quand le PDF arrive en binaire du nœud précédent.

Cas d'usage

convertir les documents signés au niveau de conformité attendu par l'archive, au moment du classement et pas des années plus tard.

Decrypt PDF

pdf.pdf/decrypt

Ce que tu vois dans n8n

Notes & cas d'usage

Retire la protection d'un PDF verrouillé par mot de passe et renvoie une copie lisible pour la suite du workflow.

Paramètres clés

Password : le mot de passe du fichier chiffré, à aller chercher dans un coffre plutôt qu'à taper dans le nœud.
Input File Contents : le contenu texte quand le fichier est envoyé sous cette forme.
Binary Property : le champ binaire qui porte le PDF verrouillé.

Cas d'usage

les relevés bancaires arrivent protégés chaque mois, et aucun nœud d'extraction ne les lit tant que cette étape n'a pas tourné.

Encrypt PDF

pdf.pdf/encrypt

Ce que tu vois dans n8n

Notes & cas d'usage

Verrouille un PDF et, au-delà du mot de passe, décide de ce que le lecteur a le droit d'en faire.

Paramètres clés

Set Password : le mot de passe demandé à l'ouverture.
Set Owner Password : le mot de passe propriétaire, qui permet de lever toutes les protections.
Allow Print et Allow Modify : les niveaux autorisés, par exemple full et form.
Allow Extract et Allow Accessibility : la copie du contenu, et le support des lecteurs d'écran.

Cas d'usage

envoyer les bulletins de paie verrouillés, en laissant l'accessibilité active pour que le document reste utilisable.

Extract pages from PDF

pdf.pdf/extract-pages

Ce que tu vois dans n8n

Notes & cas d'usage

Sort les pages choisies d'un PDF et les renvoie dans un nouveau fichier, sans toucher au document source.

Paramètres clés

Pages : des pages seules ou des plages, par exemple 1,2,5-7 ; la numérotation commence à 1.
Binary Property : le champ qui porte le PDF à découper.
Binary Input Data : coché quand le PDF est la sortie binaire d'un nœud antérieur.

Cas d'usage

ne garder que les pages de signature d'un accord long pour les envoyer en contresignature, sans faire circuler tout le contrat.

Merge files to PDF

pdf.pdf/merge

Ce que tu vois dans n8n

Notes & cas d'usage

Assemble plusieurs fichiers dans un PDF unique, dans l'ordre où les items atteignent le nœud. Aucun paramètre n'est requis ici, ce qui en fait l'opération la plus simple du nœud et la plus facile à poser en bout de branche, là où le workflow a rassemblé des fichiers venus de sources différentes.

Cas d'usage

un devis, des conditions générales et une annexe produits par trois étapes distinctes, et le client reçoit un document au lieu de trois pièces jointes à ouvrir dans le bon ordre.

Rotate PDF pages

pdf.pdf/rotate-pages

Ce que tu vois dans n8n

Notes & cas d'usage

Fait pivoter une page ou toutes les pages d'un PDF, ce qui répare les documents passés à l'envers dans le scanner.

Paramètres clés

Rotation : l'angle appliqué, par exemple +90, -90 ou 180.
Pages : les pages ou plages à faire tourner, comme 1,2,5-7, la numérotation commençant à 1.
Binary Property : le champ binaire qui contient le fichier.

Cas d'usage

redresser les pages en paysage d'un jeu de plans scannés avant une étape OCR, qui lit bien mieux un texte à l'endroit.

Split PDF into pages

pdf.pdf/split-pages

Ce que tu vois dans n8n

Notes & cas d'usage

Découpe un PDF en un fichier par page, pour transformer un document groupé en liste d'items sur laquelle le workflow peut boucler.

Paramètres clés

Binary Property : le champ qui porte le PDF à découper.
Binary Input Data : coché pour prendre le document dans ce champ binaire.
Input File Contents : le contenu texte, pour la voie de l'envoi direct.

Cas d'usage

un scanner sort un seul PDF pour une liasse de formulaires, et chaque page doit partir vers un dossier ou une personne différente.

Website

1 opération

Capture website

website.capture-website

Ce que tu vois dans n8n

Notes & cas d'usage

Rend une page web en direct et la renvoie en PDF, en JPG ou en PNG. C'est la seule opération qui part d'une URL et non d'un fichier.

Paramètres clés

URL : l'adresse de la page à capturer.
Output Format : PDF pour un document, JPG ou PNG pour une capture d'écran.
Additional Options : un dictionnaire JSON d'options supplémentaires pour la tâche, construit avec le job builder de CloudConvert.

Cas d'usage

garder chaque semaine une capture datée d'une page tarifaire concurrente, pour constater le changement au lieu de s'en souvenir.

Besoin d'aide

Besoin d'aide pour automatiser CloudConvert avec n8n ?

L'équipe te répond directement.

Chaque message est lu par une personne.

FAQ

CloudConvert et n8n, les questions qui suivent

01L'intégration CloudConvert n8n est-elle gratuite ?

Côté n8n, oui. Le nœud n'ajoute aucun coût, que n8n tourne en auto-hébergement via Docker ou npm, ou sur n8n Cloud, l'offre hébergée par n8n. La nuance porte sur l'installation : CloudConvert est un nœud communautaire, il n'est pas livré avec n8n. Le paquet npm @cloudconvert/n8n-nodes-cloudconvert, en version 1.1.1, s'installe depuis Settings puis Community nodes, sur une instance auto-hébergée. Sur n8n Cloud, seuls les nœuds communautaires vérifiés passent. Ce que CloudConvert facture pour les traitements est une autre question, qui se règle dans le compte CloudConvert.

02Quels credentials CloudConvert faut-il dans n8n ?

Deux méthodes d'authentification sont proposées par le nœud. OAuth2 est celle recommandée : tu autorises la connexion et CloudConvert remet un jeton à n8n. API Key est l'autre, avec une clé issue du compte CloudConvert collée dans le credential. Dans les deux cas, le credential se crée une seule fois dans le menu Credentials, puis se réutilise dans tous les workflows qui touchent à CloudConvert, puisque le nœud le propose dans sa liste déroulante. Une deuxième chaîne de traitement n'a donc pas besoin d'une deuxième clé, et la rotation se fait à un seul endroit.

03Quelles sont les limites du nœud CloudConvert ?

Le nœud couvre 17 opérations réparties sur 5 ressources, en version 1, et cette liste fait la frontière. Tout ce que l'API CloudConvert sait faire au-delà reste atteignable avec le nœud HTTP Request, qui appelle n'importe quel endpoint en réutilisant le même credential via l'authentification prédéfinie. L'autre limite tient au nœud communautaire lui-même : il s'installe sur une instance auto-hébergée, et n8n Cloud n'accepte que les nœuds vérifiés. Enfin, un champ marqué requis bloque l'exécution du nœud s'il est vide, ce qui se remarque tard dans une longue chaîne de traitement de fichiers.

04CloudConvert peut-il déclencher un workflow n8n ?

Non, CloudConvert n'a pas de nœud trigger dans n8n. Un workflow qui l'utilise démarre donc autrement : un Schedule Trigger à intervalle fixe, un Webhook n8n, c'est-à-dire une URL appelée par un service tiers, ou le trigger d'un autre outil déjà en place. En pratique la gêne est faible, parce que le fichier arrive justement par cet autre outil, une boîte mail, un formulaire ou un dépôt de document. CloudConvert se place alors au milieu du workflow comme une action : il reçoit le fichier binaire et renvoie le fichier transformé.

05n8n ou Make pour CloudConvert ?

Quatre critères tranchent. L'hébergement d'abord : n8n s'auto-héberge avec Docker ou npm, ou s'utilise sur n8n Cloud, quand Make est hébergé uniquement. La maîtrise des données en découle, puisqu'une instance auto-hébergée garde les fichiers chez toi, ce qui pèse quand les documents sont des contrats ou des bulletins de paie. Le modèle de coût ensuite : Make facture à l'opération, et une chaîne qui découpe un PDF page par page en produit beaucoup. La logique visuelle diffère aussi, alors le test honnête consiste à reconstruire le même workflow des deux côtés.

Installer le nœud communautaire

Créer le credential

Le choisir dans le nœud et tester

Besoin d'aide pour automatiser CloudConvert avec n8n ?