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
À 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.
Comment connecter S3 à n8n ?
- 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 partsec_. Ce secret ne s'affiche qu'une fois, copie-le avant de fermer. - 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 exemplenyc3chez Spaces ouautochez Tigris. Puis Access Key ID et Secret Access Key issus de l'étape précédente. - 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.
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.
| Ressource | Create | Get Many | Delete | Copy | Download | Search | Upload |
|---|---|---|---|---|---|---|---|
| Bucket | ✓ | ✓ | ✓ | ✓ | |||
| File | ✓ | ✓ | ✓ | ✓ | ✓ | ||
| Folder | ✓ | ✓ | ✓ |
Sommaire des opérations
Bucket
4 opérationsCreate a bucket
bucket.createCe 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.
Delete a bucket
bucket.deleteCe 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 }}.
Get many buckets
bucket.getAllCe 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é.
Search a bucket
bucket.searchCe que tu vois dans n8n
Notes & cas d'usage
Filtre les clés d'un bucket côté serveur, ce qui se rapproche le plus d'une recherche avec ce nœud. La réponse porte les clés des objets, pas leur contenu.
Paramètres clés
- Bucket Name : le bucket sur lequel porte la recherche.
- Prefix : limite la réponse aux clés qui commencent par cette chaîne, du genre
invoices/2025/. - Delimiter : le caractère qui sert à regrouper les clés, c'est lui qui fait ressembler un espace de clés plat à une arborescence.
- Start After : la clé à partir de laquelle le listage reprend, utile sur un balayage long.
File
5 opérationsCopy a file
file.copyCe 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.
Delete a file
file.deleteCe 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.
Download a file
file.downloadCe 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.
Get many files
file.getAllCe 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.
Upload a file
file.uploadCe 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.
Folder
3 opérationsCreate a folder
folder.createCe 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.
Delete a folder
folder.deleteCe 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.
Get many folders
folder.getAllCe 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.
Besoin d'aide pour automatiser S3 avec n8n ?
L'équipe te répond directement.
Chaque message est lu par une personne.

