Integración S3 n8nAutomatiza S3 con n8n.
Tus archivos viven en un MinIO, un Wasabi o un Space de DigitalOcean, y un flujo de trabajo necesita alcanzarlos. La integración S3 n8n reúne 12 operaciones sobre 3 recursos: buckets, archivos y carpetas. Nadie escucha por su cuenta, así que la ejecución arranca desde otro nodo.
Reseñas verificadas en Trustpilot · Agencia de IA, automatización y growth
¿Qué resuelve la integración S3 n8n?
El nodo S3 habla con cualquier almacenamiento compatible con S3 que no sea el de Amazon: MinIO, Wasabi, DigitalOcean Spaces o Tigris. Le das a n8n una URL de endpoint, una región y un par de claves de acceso, y a partir de ahí crea, lee y borra buckets, archivos y carpetas desde el propio flujo. Para el servicio de Amazon, n8n trae un nodo AWS S3 aparte: no son intercambiables, porque las credenciales no tienen la misma forma.
Primer escenario, el respaldo que corre de madrugada. Un Schedule Trigger arranca, una consulta contra Microsoft SQL devuelve los movimientos del día, el flujo los arma como texto CSV y file.upload escribe ese texto en una carpeta con fecha usando el parámetro File Content. Sin binarios y sin pasar por el disco de nadie.
Segundo escenario, los documentos generados. Un nodo HTTP Request recoge un informe o una imagen producida en otro sitio y la entrega como datos binarios, file.upload la guarda bajo una clave predecible y esa clave termina en una fila de Google Sheets que hace de índice. Es la forma exacta de las plantillas S3 publicadas, donde el nodo aparece junto a HTTP Request y poco más.
Tercer escenario, la entrada de material externo. Un nodo Webhook, es decir una URL de n8n que un sistema ajeno llama, recibe el archivo de un proveedor, y este cae en el bucket que bucket.create abrió al dar de alta a ese proveedor. Conviene recordar que la subida exige que el archivo llegue desde un nodo anterior como propiedad de datos: Read/Write Files from Disk o HTTP Request cumplen ese papel. Un caso parecido es guardar los artefactos que publica un repositorio de GitHub.
¿Cuándo tirar de HTTP Request? El nodo expone 12 operaciones y ahí termina su superficie. Lo demás de la API S3 de tu proveedor queda a un nodo HTTP Request de distancia, reutilizando la misma credencial con autenticación predefinida, así las claves no se copian dentro del flujo.
Los límites conviene tenerlos claros antes de montar nada. No hay trigger de S3, o sea que nada reacciona solo cuando aparece un objeto. Tampoco hay mover ni renombrar: reubicar un archivo es file.copy y luego file.delete. Los listados se detienen en Limit mientras Return All siga desmarcado, algo que pesa en un bucket con miles de claves. Y en Wasabi los permisos se fijan sí o sí desde el desplegable ACL, nunca con los interruptores de concesión. Si el equipo arranca de cero con n8n, el Curso n8n cubre credenciales y expresiones antes de tocar datos reales.
¿Cómo conectar S3 con n8n?
- 01
Genera la clave de acceso en tu proveedor
Todo almacenamiento compatible con S3 entrega un par de claves. En DigitalOcean Spaces está en Settings, luego la página API y la pestaña Spaces Keys, donde Generate New Key muestra una Key y un Secret. En Tigris es la sección Access Keys de la consola: el identificador empieza por
tid_y el secreto portsec_. Ese secreto aparece una sola vez, cópialo antes de cerrar la ventana. - 02
Rellena la credencial S3 en n8n
Entra en el menú Credentials de n8n, elige S3 y pega cuatro valores. S3 Endpoint es la URL del almacenamiento, con
https://delante. Region es la región donde está tu bucket, lo que algunos proveedores llaman region slug, por ejemplonyc3en Spaces oautoen Tigris. Después Access Key ID y Secret Access Key del paso anterior. - 03
Ajusta los dos interruptores de direccionamiento
Force Path Style pasa la conexión a direccionamiento de buckets por ruta. DigitalOcean Spaces y Tigris lo quieren apagado, porque ambos usan el formato por subdominio. Ignore SSL Issues deja que n8n conecte aunque falle la validación del certificado, situación habitual contra un MinIO autoalojado con certificado propio. Fuera de ese caso, déjalo apagado. Guardada una vez, la credencial aparece en todos los flujos.
Las 12 operaciones del nodo S3
El nodo S3 expone 12 operaciones en 3 recursos. Para cada una: el nodo tal como lo configuras en n8n, los campos obligatorios y nuestras notas de campo.
| Recurso | Create | Get Many | Delete | Copy | Download | Search | Upload |
|---|---|---|---|---|---|---|---|
| Bucket | ✓ | ✓ | ✓ | ✓ | |||
| File | ✓ | ✓ | ✓ | ✓ | ✓ | ||
| Folder | ✓ | ✓ | ✓ |
Índice de operaciones
Bucket
4 operacionesCreate a bucket
bucket.createLo que ves en n8n
Notas y casos de uso
Crea un bucket en el almacenamiento al que apunta la credencial. Aterriza en la región definida en esa credencial, salvo que la llamada indique otra.
Parámetros clave
- Name: el nombre del bucket, muchas veces una expresión tipo
{{ $json.account_slug }}cuando un flujo aprovisiona espacio por cuenta. - ACL: la canned ACL que se aplica al crear, desde Authenticated Read hasta Public Read Write. Private lo deja cerrado a las llamadas anónimas.
- Region: solo hace falta si el bucket debe vivir fuera de la región de la credencial.
Delete a bucket
bucket.deleteLo que ves en n8n
Notas y casos de uso
Le pasas un nombre de bucket y el servidor lo elimina. El nodo no pide ninguna confirmación, de modo que lo que resuelva la expresión es lo que desaparece.
Parámetros clave
- Name: el nombre del bucket a borrar, escrito a mano o heredado de un item anterior con
{{ $json.Name }}.
Get many buckets
bucket.getAllLo que ves en n8n
Notas y casos de uso
Devuelve los buckets que ve la clave de acceso, un item de n8n por bucket. Va bien como primer paso, cuando el flujo necesita saber qué existe antes de escribir nada.
Parámetros clave
- Return All: marcado, n8n encadena las páginas de la API hasta el último bucket; sin marcar, se detiene en Limit.
- Limit: el techo de items devueltos mientras Return All siga apagado.
Search a bucket
bucket.searchLo que ves en n8n
Notas y casos de uso
Filtra las claves de un bucket del lado del servidor, lo más parecido a una búsqueda que ofrece este nodo. La respuesta trae las claves de los objetos, no su contenido.
Parámetros clave
- Bucket Name: el bucket sobre el que se busca.
- Prefix: acota la respuesta a las claves que empiezan por esa cadena, por ejemplo
invoices/2025/. - Delimiter: el carácter que agrupa claves, el truco que hace que un espacio plano parezca un árbol de carpetas.
- Start After: la clave desde la que continúa el listado, útil para retomar un barrido largo.
File
5 operacionesCopy a file
file.copyLo que ves en n8n
Notas y casos de uso
Duplica un objeto de una ubicación a otra sin que los bytes pasen por n8n. Ambas rutas empiezan con una barra y el nombre del bucket, seguidos de la clave.
Parámetros clave
- Source Path: bucket y clave del original, con el formato
/bucket/my-image.jpg. - Destination Path: destino de la copia, mismo formato, por ejemplo
/bucket/my-second-image.jpg. - Metadata Directive: Copy conserva los metadatos del origen, Replace pone los que trae la petición.
- Storage Class: la clase en la que se escribe la copia, de Standard a Deep Archive.
Delete a file
file.deleteLo que ves en n8n
Notas y casos de uso
Apunta a un objeto por su clave y lo retira del bucket. En un bucket con versiones, la llamada puede dirigirse a una versión concreta en lugar de a la vigente.
Parámetros clave
- Bucket Name: el bucket que guarda el objeto.
- File Key: la clave completa del objeto, prefijo de carpeta incluido.
- Version ID: campo opcional dentro de Options que dirige el borrado a una versión.
Download a file
file.downloadLo que ves en n8n
Notas y casos de uso
Saca un objeto del bucket y se lo entrega al resto del flujo como datos binarios, listo para el nodo que lo envía, lo lee o lo vuelve a subir.
Parámetros clave
- Bucket Name: dónde está el objeto.
- File Key: la clave que se recupera, normalmente
{{ $json.Key }}venida de Get many files. - Put Output File in Field: el nombre del campo binario de salida donde se deposita el archivo, el que tendrá que mirar el nodo siguiente.
Get many files
file.getAllLo que ves en n8n
Notas y casos de uso
Recorre el contenido de un bucket y devuelve un item por objeto, con su clave y sus metadatos. Se combina con Download a file cuando el flujo también necesita los bytes.
Parámetros clave
- Bucket Name: el bucket que se lista.
- Folder Key: reduce el listado a una carpeta en vez del bucket entero.
- Fetch Owner: no viene en la respuesta por defecto, actívalo para recibir el campo propietario en cada clave.
- Return All: marcado, vuelven todos los objetos; sin marcar, Limit acota el lote.
Upload a file
file.uploadLo que ves en n8n
Notas y casos de uso
Escribe un archivo en el bucket, ya sea desde un campo binario producido antes o desde texto tecleado en el propio nodo. Es la operación sobre la que gira casi cualquier flujo con S3.
Parámetros clave
- Bucket Name: el bucket de destino.
- File Name: el nombre que toma el objeto, por ejemplo
hello.txt. - Input Binary Field: el campo binario de entrada que contiene el archivo, alimentado por Read/Write Files from Disk o HTTP Request.
- Binary File: apagado, el nodo usa File Content, el texto que escribes, en lugar de un campo binario.
- ACL: en Wasabi los permisos se ajustan con este desplegable y no con los interruptores.
Folder
3 operacionesCreate a folder
folder.createLo que ves en n8n
Notas y casos de uso
En S3 una carpeta es una convención de nombres más que un directorio real, y esta operación escribe la clave que la hace visible en la consola y en los listados.
Parámetros clave
- Bucket Name: el bucket que acoge la carpeta.
- Folder Name: el nombre de la carpeta a secas, sin la ruta del padre.
- Parent Folder Key: la carpeta dentro de la cual quieres crear esta, que es como se expresa el anidamiento.
- Storage Class: de Standard a Reduced Redundancy, según lo que vaya a acumularse ahí.
Delete a folder
folder.deleteLo que ves en n8n
Notas y casos de uso
Quita una carpeta de un bucket a partir de su clave. Como una carpeta es solo una clave, la operación toca la estructura y no los objetos que el flujo haya ido dejando dentro.
Parámetros clave
- Bucket Name: el bucket afectado.
- Folder Key: la clave de la carpeta que se retira, con la ruta del padre incluida.
Get many folders
folder.getAllLo que ves en n8n
Notas y casos de uso
Enumera las carpetas que hay en un bucket, un item por cada una, para que un flujo pueda iterar sobre ellas sin conocer de antemano la estructura.
Parámetros clave
- Bucket Name: el bucket que se explora.
- Folder Key: limita la respuesta a lo que cuelga de una carpeta concreta.
- Return All: marcado, el nodo encadena páginas; sin marcar, Limit fija el máximo devuelto.
- Fetch Owner: añade el campo propietario a cada clave del resultado.
¿Necesitas ayuda para automatizar S3 con n8n?
El equipo te responde directamente.
Cada mensaje lo lee una persona.


