Ressources · Intégration n8n

Intégration S3 n8nAutomatiser S3 avec n8n.

Tes fichiers dorment sur un MinIO, un Wasabi ou un Space DigitalOcean, et un workflow doit aller les chercher. L'intégration S3 n8n donne 12 opérations réparties sur 3 ressources : buckets, fichiers, dossiers. Rien n'écoute tout seul, c'est un autre nœud qui lance l'exécution.

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

Pourquoi automatiser

À quoi sert l'intégration S3 n8n ?

Le nœud S3 parle à n'importe quel stockage compatible S3 qui n'est pas celui d'Amazon : MinIO, Wasabi, DigitalOcean Spaces ou Tigris. Tu donnes à n8n une URL d'endpoint, une région et une paire de clés d'accès, et le nœud crée, lit et supprime buckets, fichiers et dossiers depuis un workflow. Pour le service d'Amazon, n8n livre un nœud AWS S3 distinct : les deux ne se remplacent pas, les credentials n'ont pas la même forme.

Premier scénario, la sauvegarde qui tourne la nuit. Un Schedule Trigger démarre, une requête sur MySQL sort les commandes de la journée, le workflow les assemble en texte CSV, et file.upload écrit ce texte dans un dossier daté via le paramètre File Content. Aucun fichier binaire à manipuler, aucun poste de travail dans la boucle.

Deuxième scénario, les documents générés. Un nœud HTTP Request récupère un PDF ou une image produite ailleurs et la transmet en données binaires, file.upload la range sous une clé prévisible, et cette clé part dans une collection MongoDB qui sert d'index. C'est exactement la forme des templates S3 publiés, qui associent le nœud à HTTP Request et rien d'autre.

Troisième scénario, l'archivage des pièces jointes. Le trigger d'un autre outil, par exemple celui de Gmail, attrape une facture fournisseur, le fichier arrive en données binaires et atterrit dans le bucket du mois. Pour un envoi, le fichier doit toujours venir d'un nœud précédent sous forme de propriété de données : Read/Write Files from Disk ou HTTP Request font le travail.

Quand passer par HTTP Request ? Le nœud expose 12 opérations, et c'est toute sa surface. Le reste de l'API S3 de ton fournisseur reste accessible avec un nœud HTTP Request, qui réutilise le même credential via l'authentification prédéfinie. Les clés restent au même endroit, tu ne les recopies pas dans le workflow.

Les limites à connaître avant de câbler. Pas de trigger S3, donc rien ne réagit tout seul à l'arrivée d'un objet. Pas de déplacement ni de renommage non plus : bouger un fichier, c'est file.copy puis file.delete. Les opérations de listage s'arrêtent à Limit tant que Return All n'est pas coché, ce qui change tout sur un bucket qui contient des milliers de clés. Et sur Wasabi, les permissions passent obligatoirement par la liste déroulante ACL, pas par les interrupteurs de droits. Si tu compares encore les plateformes, l'Avis n8n détaille l'hébergement et le modèle de coût.

Connexion

Comment connecter S3 à n8n ?

  1. 01

    Générer la clé d'accès chez ton fournisseur

    Chaque stockage compatible S3 délivre une paire de clés. Sur DigitalOcean Spaces, elle se trouve dans Settings, puis la page API, puis l'onglet Spaces Keys : Generate New Key affiche une Key et un Secret. Sur Tigris, c'est la section Access Keys de la console, l'identifiant commence par tid_ et le secret par tsec_. Ce secret ne s'affiche qu'une fois, copie-le avant de fermer.

  2. 02

    Remplir le credential S3 dans n8n

    Dans le menu Credentials de n8n, choisis S3 et colle quatre valeurs. S3 Endpoint, c'est l'URL du stockage, préfixée par https://. Region, c'est la région du bucket, que certains fournisseurs appellent region slug, par exemple nyc3 chez Spaces ou auto chez Tigris. Puis Access Key ID et Secret Access Key issus de l'étape précédente.

  3. 03

    Régler les deux interrupteurs d'adressage

    Force Path Style bascule la connexion sur un adressage des buckets par chemin. DigitalOcean Spaces et Tigris le veulent désactivé, tous deux utilisent le format en sous-domaine. Ignore SSL Issues autorise n8n à se connecter même si la validation du certificat échoue, cas courant face à un MinIO auto-hébergé avec son propre certificat. Sinon, laisse-le éteint. Un credential enregistré une fois se retrouve dans tous les workflows.

Actions

Les 12 opérations du nœud S3

Le nœud S3 expose 12 opérations sur 3 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
RessourceCreateGet ManyDeleteCopyDownloadSearchUpload
Bucket✓✓✓✓
File✓✓✓✓✓
Folder✓✓✓

Bucket

4 opérations
01

Create a bucket

bucket.create

Ce que tu vois dans n8n

Notes & cas d'usage

Crée un bucket sur le stockage visé par le credential. Il se pose dans la région définie sur ce credential, sauf si l'appel en désigne une autre.

Paramètres clés

  • Name : le nom du bucket, souvent une expression comme {{ $json.account_slug }} quand un workflow provisionne un espace par compte.
  • ACL : la canned ACL appliquée à la création, d'Authenticated Read à Public Read Write. Private ferme le bucket aux appels anonymes.
  • Region : utile seulement si le bucket doit vivre ailleurs que dans la région du credential.
Cas d'usage
l'arrivée d'un client qui a droit à son stockage isolé, créé par le workflow qui crée aussi sa fiche.
02

Delete a bucket

bucket.delete

Ce que tu vois dans n8n

Notes & cas d'usage

Tu passes un nom de bucket, le serveur le supprime. Le nœud ne demande aucune confirmation : ce que l'expression renvoie est ce qui disparaît.

Paramètres clés

  • Name : le nom du bucket à supprimer, saisi en dur ou repris d'un item précédent avec {{ $json.Name }}.
Cas d'usage
démonter le bucket de test créé en début de recette, ou libérer l'espace d'un compte résilié depuis longtemps.
03

Get many buckets

bucket.getAll

Ce que tu vois dans n8n

Notes & cas d'usage

Renvoie les buckets visibles par la clé d'accès, un item n8n par bucket. Pratique en première étape, quand le workflow doit savoir ce qui existe avant d'écrire quoi que ce soit.

Paramètres clés

  • Return All : coché, n8n enchaîne les pages de l'API jusqu'au dernier bucket ; décoché, il s'arrête à Limit.
  • Limit : le plafond d'items renvoyés quand Return All reste décoché.
Cas d'usage
l'inventaire mensuel du stockage, ou le garde-fou qui vérifie l'existence du bucket client avant l'envoi.

File

5 opérations
05

Copy a file

file.copy

Ce que tu vois dans n8n

Notes & cas d'usage

Duplique un objet d'un emplacement vers un autre sans faire transiter les octets par n8n. Les deux chemins commencent par une barre oblique et le nom du bucket, suivis de la clé.

Paramètres clés

  • Source Path : bucket et clé de l'original, sous la forme /bucket/my-image.jpg.
  • Destination Path : la destination de la copie, même format, par exemple /bucket/my-second-image.jpg.
  • Metadata Directive : Copy garde les métadonnées de la source, Replace met celles fournies dans la requête.
  • Storage Class : la classe de stockage de la copie, de Standard à Deep Archive.
Cas d'usage
faire passer un document validé du bucket d'entrée vers celui des dossiers traités.
06

Delete a file

file.delete

Ce que tu vois dans n8n

Notes & cas d'usage

Vise un objet par sa clé et l'enlève du bucket. Sur un bucket versionné, l'appel peut cibler une version précise plutôt que la version courante.

Paramètres clés

  • Bucket Name : le bucket qui contient l'objet.
  • File Key : la clé complète de l'objet, préfixe de dossier compris.
  • Version ID : champ facultatif de la collection Options, qui pointe la suppression sur une version.
Cas d'usage
la seconde moitié d'un déplacement, juste après Copy a file, ou la purge des exports qui dépassent la durée de conservation que tu t'es fixée.
07

Download a file

file.download

Ce que tu vois dans n8n

Notes & cas d'usage

Sort un objet du bucket et le remet au reste du workflow en données binaires, prêt pour un nœud qui l'envoie, le lit ou le repousse ailleurs.

Paramètres clés

  • Bucket Name : le bucket où se trouve l'objet.
  • File Key : la clé à récupérer, en général {{ $json.Key }} hérité de Get many files.
  • Put Output File in Field : le nom du champ binaire de sortie dans lequel le fichier est déposé, celui que le nœud suivant devra viser.
Cas d'usage
aller chercher un contrat stocké pour le joindre à un email de relance.
08

Get many files

file.getAll

Ce que tu vois dans n8n

Notes & cas d'usage

Parcourt le contenu d'un bucket et renvoie un item par objet, avec sa clé et ses métadonnées. À combiner avec Download a file quand le workflow a aussi besoin des octets.

Paramètres clés

  • Bucket Name : le bucket à lister.
  • Folder Key : restreint le listage à un dossier au lieu du bucket entier.
  • Fetch Owner : absent de la réponse par défaut, active-le pour obtenir le champ propriétaire sur chaque clé.
  • Return All : coché, tous les objets remontent ; décoché, Limit borne le lot.
Cas d'usage
compter chaque matin les fichiers déposés par un partenaire dans son dossier d'envoi.
09

Upload a file

file.upload

Ce que tu vois dans n8n

Notes & cas d'usage

Écrit un fichier dans le bucket, soit depuis un champ binaire produit en amont, soit depuis du texte saisi dans le nœud. C'est l'opération autour de laquelle tournent la plupart des workflows S3.

Paramètres clés

  • Bucket Name : le bucket de destination.
  • File Name : le nom que prend l'objet, par exemple hello.txt.
  • Input Binary Field : le champ binaire d'entrée qui contient le fichier, alimenté par Read/Write Files from Disk ou HTTP Request.
  • Binary File : décoché, le nœud prend File Content, le texte que tu fournis, au lieu d'un champ binaire.
  • ACL : sur Wasabi, les permissions se règlent avec cette liste déroulante et pas avec les interrupteurs.
Cas d'usage
archiver un devis signé à la seconde où le formulaire le renvoie.

Folder

3 opérations
10

Create a folder

folder.create

Ce que tu vois dans n8n

Notes & cas d'usage

Dans S3, un dossier est une convention de nommage plus qu'un vrai répertoire. Cette opération écrit la clé qui le fait apparaître dans la console et dans les listages.

Paramètres clés

  • Bucket Name : le bucket qui accueille le dossier.
  • Folder Name : le nom du dossier seul, sans le chemin parent.
  • Parent Folder Key : le dossier dans lequel tu veux créer celui-ci, c'est comme ça que s'exprime l'imbrication.
  • Storage Class : de Standard à Reduced Redundancy, selon ce qui va s'y accumuler.
Cas d'usage
ouvrir un dossier par mois au démarrage d'un workflow d'export.
11

Delete a folder

folder.delete

Ce que tu vois dans n8n

Notes & cas d'usage

Retire un dossier d'un bucket à partir de sa clé. Comme un dossier n'est qu'une clé, l'opération touche la structure, pas les objets que le workflow a pu ranger dedans.

Paramètres clés

  • Bucket Name : le bucket concerné.
  • Folder Key : la clé du dossier à retirer, chemin parent inclus.
Cas d'usage
refermer l'espace d'un projet une fois les livrables copiés vers le stockage longue durée, ou nettoyer les dossiers temporaires créés plus tôt dans l'exécution.
12

Get many folders

folder.getAll

Ce que tu vois dans n8n

Notes & cas d'usage

Liste les dossiers présents dans un bucket, un item chacun, pour qu'un workflow puisse boucler dessus sans connaître l'arborescence à l'avance.

Paramètres clés

  • Bucket Name : le bucket à explorer.
  • Folder Key : réduit la réponse à ce qui se trouve sous un dossier donné.
  • Return All : coché, le nœud enchaîne les pages ; décoché, Limit fixe le maximum renvoyé.
  • Fetch Owner : ajoute le champ propriétaire à chaque clé du résultat.
Cas d'usage
passer sur un dossier par client pour leur appliquer la même étape d'archivage.
Besoin d'aide

Besoin d'aide pour automatiser S3 avec n8n ?

L'équipe te répond directement.

Chaque message est lu par une personne.

FAQ

S3 et n8n, les questions qui reviennent

01L'intégration S3 n8n est-elle gratuite ?
Oui, côté n8n. Le nœud S3 est livré avec n8n, il n'y a rien à installer et rien à payer en plus, que tu sois sur n8n Cloud ou sur une instance auto-hébergée en Community Edition sous licence Sustainable Use. Un workflow se comporte pareil dans les deux cas. Ce que tu paies, c'est le stockage lui-même, et ça se règle avec ton fournisseur : le nœud se contente de signer les requêtes vers l'endpoint que tu lui donnes. Ajouter un deuxième bucket, un deuxième fournisseur ou un deuxième workflow ne change rien à la facture côté n8n.
02Quels credentials faut-il pour le nœud S3 ?
Un seul credential S3, basé sur la méthode S3 endpoint. Quatre valeurs à fournir : S3 Endpoint, l'URL du stockage, Region, que certains fournisseurs appellent region slug, Access Key ID, la clé d'accès délivrée pour le bucket ou le space, et Secret Access Key, le secret associé. Deux interrupteurs complètent le tout : Force Path Style pour un adressage des buckets par chemin, et Ignore SSL Issues pour un backend dont le certificat ne passe pas la validation. Créé une fois dans le menu Credentials, il se réutilise dans tous les workflows.
03Quelles sont les limites du nœud S3 dans n8n ?
Le nœud s'arrête à 12 opérations sur 3 ressources. Tout le reste de l'API S3 de ton fournisseur passe par un nœud HTTP Request, qui réutilise le même credential via l'authentification prédéfinie. Pas de déplacement ni de renommage : bouger un objet, c'est Copy a file puis Delete a file. Les listages s'arrêtent à Limit tant que Return All reste décoché. Un envoi exige que le fichier arrive d'un nœud précédent en propriété de données. Et sur Wasabi, les permissions se règlent avec la liste déroulante ACL, pas avec les interrupteurs de droits.
04n8n peut-il réagir quand un fichier arrive dans un bucket ?
Pas directement, cette intégration n'a pas de nœud trigger. Un workflow qui touche à S3 démarre donc ailleurs : un Schedule Trigger qui relance la vérification à intervalle fixe, un nœud Webhook, c'est-à-dire une URL de n8n qu'un service tiers appelle quand il connaît déjà le nouvel objet, ou le trigger d'un autre outil de la chaîne. Le montage le plus courant reste un Get many files ou un Search a bucket planifié, dont le résultat est comparé à ce que l'exécution précédente avait déjà traité.
05n8n ou Make pour un stockage compatible S3 ?
Ça dépend surtout de l'endroit où les données doivent rester. n8n s'auto-héberge avec Docker ou npm, donc les buckets, les clés et les journaux d'exécution restent sur une infrastructure que tu contrôles, et il existe aussi en version hébergée avec n8n Cloud. Make est hébergé uniquement, sans option d'auto-hébergement, et facturé à l'opération : un workflow qui liste des milliers de clés n'a pas du tout le même profil de coût. Make propose un éditeur visuel que beaucoup d'équipes lisent plus vite. Des clés de stockage restent des données sensibles, ce critère pèse souvent le plus lourd.