Integración Box n8nAutomatiza Box con n8n.
Los documentos viven en Box, n8n decide qué pasa con ellos. La integración Box n8n son 13 operaciones repartidas en 2 recursos, archivos y carpetas, más un trigger que escucha 36 eventos agrupados en 8 familias. Pensada para equipos que todavía ordenan a mano.
Reseñas verificadas en Trustpilot · Agencia de IA, automatización y growth
¿Para qué sirve la integración Box n8n?
La integración Box n8n se apoya en dos nodos. El nodo Box actúa sobre la cuenta: sube, copia, descarga, busca, comparte y borra archivos, y crea, lee, busca, comparte, actualiza y borra carpetas. Son 13 operaciones sobre 2 recursos. El Box Trigger hace el camino contrario: arranca un flujo de trabajo cuando algo ocurre dentro de Box, con 36 eventos repartidos en 8 familias. Funciona por webhook, es decir, una URL que Box llama en el momento, así que el aviso llega en segundos.
El permiso que nadie retira es el mejor sitio para empezar. file.share y folder.share crean una colaboración con un usuario o un grupo, y el campo Role marca hasta dónde llega esa persona, desde Viewer hasta Co-Owner. Dentro de la colección Options, Expires At fija la fecha en la que esa colaboración se retira sola. Para un proveedor que entra tres semanas, eso separa un acceso limpio de un acceso olvidado. Cuando el proyecto cierra, folder.update renombra la carpeta y la mueve bajo el árbol de archivo.
Justo debajo aparece la parte aburrida y necesaria: que cada documento nazca en su sitio. folder.create levanta la carpeta del cliente nuevo y file.upload deja dentro la factura, el contrato o el informe que venía del paso anterior. Una fila en Google Sheets deja constancia de qué entró y cuándo, y si ese registro tiene que aguantar consultas de verdad, una tabla en Supabase hace el mismo trabajo con más músculo.
Queda la dirección opuesta, la que convierte a Box en el punto de partida. Activas el Box Trigger, marcas los eventos que te importan y Box avisa: FILE.UPLOADED cuando alguien deja un archivo en la carpeta vigilada, FILE.RENAMED cuando lo renombra, COLLABORATION.CREATED cuando invita a alguien. Ese aviso puede acabar en un correo enviado con Gmail al responsable que tiene que revisarlo.
Antes de montar nada conviene tener dos cosas claras. Las búsquedas vienen paginadas: con Return All desmarcado el nodo se detiene en la cifra de Limit, y marcado n8n recorre las páginas hasta el final. Y lo que queda fuera de las 13 operaciones del catálogo se resuelve con el nodo HTTP Request, que llama a cualquier endpoint de la API de Box reutilizando el mismo credential mediante la autenticación predefinida.
Con eso ya tienes material para el primer flujo. Si la duda todavía está en la plataforma y no en Box, la Reseña n8n cuenta en qué destaca y dónde molesta.
¿Cómo se conecta Box con n8n?
- 01
Abre una cuenta Box y crea una Custom App
El único requisito previo es una cuenta de Box. El credential de Box, la ficha de acceso que n8n guarda, se autentica con OAuth2: apruebas el acceso en el navegador en lugar de copiar una clave de un sitio a otro. Si quieres configurar ese flujo por tu cuenta, Box pide crear antes una Custom App y explica en su guía de OAuth2 qué ocurre en cada redirección. Deja esa pestaña abierta.
- 02
Crea el credential dentro de n8n
En n8n entras en el menú Credentials y creas un credential de Box. Se crea una vez y se reutiliza en todas partes: el mismo autentica el nodo Box y el Box Trigger, y cada flujo posterior lo elige de una lista desplegable. No hace falta un segundo credential para el trigger, ni pegar nada dentro del nodo. El nodo HTTP Request también se apoya en esa misma conexión.
- 03
Coloca el nodo y elige el recurso
Añade el nodo Box al lienzo, selecciona el credential y elige el recurso: File o Folder. La lista de operaciones cambia con él, siete del lado de archivos y seis del lado de carpetas. Para la parte de escucha se coloca el Box Trigger, se marcan los eventos en el campo Events y se activa el flujo. En ese momento n8n registra la URL del webhook en Box.
¿Qué puede arrancar un flujo desde Box ?
Box Trigger es el nodo que arranca un workflow cuando algo ocurre en Box. Escucha 36 eventos, listados abajo por familia. Eliges uno o varios, activas el workflow y n8n registra el webhook (la URL que Box llama) en tu cuenta.
Lo que ves en n8n
Todos los eventos, por familia
Una fila por objeto, un chip por acción. El evento que marcas en el nodo se escribe objeto.acción; pasa el cursor por un chip para leer cuándo se dispara.
FILE.*11FILE.COPIEDDELETEDDOWNLOADEDLOCKEDMOVEDPREVIEWEDRENAMEDRESTOREDTRASHEDUNLOCKEDUPLOADED
FOLDER.*8FOLDER.COPIEDCREATEDDELETEDDOWNLOADEDMOVEDRENAMEDRESTOREDTRASHED
COLLABORATION.*5COLLABORATION.ACCEPTEDCREATEDREJECTEDREMOVEDUPDATED
COMMENT.*3COMMENT.CREATEDDELETEDUPDATED
METADATA_INSTANCE.*3METADATA_INSTANCE. CREATEDDELETEDUPDATED
SHARED_LINK.*3SHARED_LINK. CREATEDDELETEDUPDATED
TASK_ASSIGNMENT.*2TASK_ASSIGNMENT. CREATEDUPDATED
WEBHOOK.*1WEBHOOK.DELETED
Notas de configuración
01Configure the Box Trigger
El Box Trigger arranca un flujo cuando ocurre un evento en Box. Trabaja con un webhook, una URL que Box llama en el instante en que pasa algo, así que el evento llega en segundos y no hay ninguna consulta periódica de por medio. n8n registra esa URL en Box al activar el flujo.
Parámetros clave
- Events: la lista de eventos que se escuchan. Uno solo, una familia entera o los 36. No existe un comodín que los cubra todos, así que un evento sin marcar no arrancará nada.
- Target Type: si el elemento vigilado es un archivo o una carpeta.
- Target ID: el identificador de Box de ese elemento, que limita la escucha a un archivo o una carpeta en vez de la cuenta entera.
02File events
Es la familia más grande, 11 eventos, y cubre la vida entera de un documento. FILE.UPLOADED salta cuando un archivo se sube a la carpeta vigilada o se mueve hacia ella, lo que la convierte en la puerta de entrada de cualquier flujo de recepción. FILE.COPIED, FILE.MOVED y FILE.RENAMED siguen al documento que cambia de sitio o de nombre.
FILE.TRASHED y FILE.DELETED corresponden a un archivo que va a la papelera, y FILE.RESTORED al que sale de ella. Otros tres hablan de personas más que de almacenamiento: FILE.PREVIEWED y FILE.DOWNLOADED confirman que alguien abrió o se llevó el documento, mientras que FILE.LOCKED y FILE.UNLOCKED avisan de un bloqueo de edición puesto o retirado.
03Folder events
Ocho eventos repiten la misma idea un nivel más arriba. FOLDER.CREATED salta al crearse una carpeta, que suele ser la primera señal de que empieza un cliente, un proyecto o un expediente. FOLDER.COPIED, FOLDER.MOVED y FOLDER.RENAMED siguen las reorganizaciones, esas que rompen en silencio los enlaces que todo el mundo tenía guardados.
Tres eventos separan tres situaciones distintas: FOLDER.TRASHED para la papelera, FOLDER.DELETED para la eliminación definitiva y FOLDER.RESTORED para la vuelta atrás. La diferencia importa cuando el flujo del otro lado tiene que elegir entre avisar a alguien y deshacer algo. FOLDER.DOWNLOADED cierra la familia, y salta cuando alguien se descarga la carpeta completa.
04Collaboration and shared link events
Estas dos familias, 5 y 3 eventos, forman la cara de los accesos. En colaboración, COLLABORATION.CREATED marca la invitación enviada, COLLABORATION.ACCEPTED y COLLABORATION.REJECTED la respuesta de la persona invitada, COLLABORATION.UPDATED un cambio de nivel de acceso y COLLABORATION.REMOVED un acceso retirado.
Los enlaces compartidos funcionan igual pero llegan más lejos: SHARED_LINK.CREATED, SHARED_LINK.UPDATED y SHARED_LINK.DELETED saltan cuando un enlace a un documento se crea, se modifica o se borra. Un enlace compartido llega más lejos que una colaboración, así que suele ser el primero que interesa vigilar.
05Comment, metadata, task and webhook events
Cuatro familias pequeñas cierran la lista, 9 eventos entre las cuatro. Los comentarios aportan 3: COMMENT.CREATED, COMMENT.UPDATED y COMMENT.DELETED, útiles cuando la revisión ocurre dentro de Box y no por correo.
Las instancias de metadatos aportan otros 3. METADATA_INSTANCE.CREATED salta cuando una plantilla de metadatos se asocia a un archivo o una carpeta, METADATA_INSTANCE.UPDATED cuando uno de sus valores cambia y METADATA_INSTANCE.DELETED cuando la instancia desaparece. Si el equipo clasifica documentos con plantillas, esta es la familia que transporta esa señal.
Las asignaciones de tarea aportan 2, TASK_ASSIGNMENT.CREATED y TASK_ASSIGNMENT.UPDATED. Y WEBHOOK.DELETED va por libre: salta cuando se borra un webhook, el único evento que avisa de que la propia fontanería ha desaparecido.
¿Qué sabe hacer el nodo Box ?
El nodo Box expone 13 operaciones en 2 recursos. Para cada una: el nodo tal como lo configuras en n8n, los campos obligatorios y nuestras notas de campo.
| Recurso | Create | Get | Update | Delete | Copy | Download | Search | Share | Upload |
|---|---|---|---|---|---|---|---|---|---|
| File | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ||
| Folder | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
Índice de operaciones
File
7 operacionesCopy a file
file.copyLo que ves en n8n
Notas y casos de uso
Duplica un archivo dentro de otra carpeta y devuelve la copia. El original se queda donde estaba.
Parámetros clave
- File ID: obligatorio, el identificador de Box del archivo que se duplica.
- Parent ID: la carpeta de destino. Si se deja vacío, la copia cae en la raíz, que casi nunca es la intención.
- Name: dentro de Additional Fields, un nombre nuevo para la copia, la forma limpia de no tener dos archivos iguales.
- Version: dentro de Additional Fields, el identificador de una versión concreta a copiar en lugar de la actual.
Delete a file
file.deleteLo que ves en n8n
Notas y casos de uso
Quita un archivo de Box desde el propio flujo, y la limpieza deja de ser una tarea de viernes por la tarde.
Parámetros clave
- File ID: el archivo que se quita. El campo espera el identificador de Box, no el nombre del archivo, así que conviene traerlo de un paso Get o Search anterior.
Download a file
file.downloadLo que ves en n8n
Notas y casos de uso
Trae el contenido del archivo al flujo como datos binarios, listos para que el nodo siguiente los use.
Parámetros clave
- Put Output File in Field: obligatorio, el nombre del campo binario de salida donde se deposita el archivo. Lo que escribas aquí es lo que tendrá que apuntar el nodo de después.
- File ID: qué archivo se descarga.
Get a file
file.getLo que ves en n8n
Notas y casos de uso
Lee la información de un archivo y la devuelve al flujo. Es el paso de consulta, no el del contenido.
Parámetros clave
- File ID: el archivo que se lee.
- Fields: dentro de Additional Fields, una lista de atributos separados por comas para incluir en la respuesta. También sirve para pedir atributos que una respuesta estándar no devuelve.
Search a file
file.searchLo que ves en n8n
Notas y casos de uso
Lanza una búsqueda sobre el contenido de Box y devuelve los archivos que encajan.
Parámetros clave
- Query: el texto que se busca. Box lo compara con nombres, descripciones, el contenido de texto de los archivos y otros campos, así que una palabra escondida dentro de un documento también aparece.
- Return All: marcado, n8n recorre todas las páginas de resultados; desmarcado, se detiene en Limit.
- File Extensions: dentro de Additional Fields, una lista separada por comas como
pdf,png,gif. - Size Range: dentro de Additional Fields, un rango en bytes tipo
1000000,5000000.
Share a file
file.shareLo que ves en n8n
Notas y casos de uso
Da acceso a una persona sobre un archivo concreto creando una colaboración encima de él.
Parámetros clave
- File ID: el archivo que se comparte.
- Accessible By: un usuario (User) o un grupo (Group).
- Use Email: marcado, identificas a la persona por Email; desmarcado, por User ID. Los grupos van por Group ID.
- Role: el nivel concedido, de Viewer o Previewer hasta Editor y Co-Owner, con las variantes Uploader para acceso de solo subida.
- Expires At: dentro de Options, la fecha en la que la colaboración se retira sola.
- Notify: si la persona recibe un correo con el aviso.
Upload a file
file.uploadLo que ves en n8n
Notas y casos de uso
Deja un archivo nuevo en Box, a partir de datos binarios que viajan en el flujo o de un texto construido en un paso anterior.
Parámetros clave
- Binary File: obligatorio, indica si los datos vienen de un campo binario o de texto.
- Input Binary Field: obligatorio con Binary File marcado, el nombre del campo binario de entrada que contiene el archivo.
- File Content: obligatorio con Binary File desmarcado, el contenido de texto del archivo.
- File Name: el nombre con el que se guarda, por ejemplo
photo.png. - Parent ID: la carpeta de destino. Sin él, la raíz.
Folder
6 operacionesCreate a folder
folder.createLo que ves en n8n
Notas y casos de uso
Crea una carpeta y la devuelve, de modo que el flujo va levantando su propio orden sobre la marcha.
Parámetros clave
- Name: obligatorio, el nombre de la carpeta.
- Parent ID: la carpeta padre. Vacío, se crea en la raíz.
- Access: dentro de Options, Collaborators solo acepta direcciones de colaboradores registrados y Open acepta cualquier dirección.
- Fields: dentro de Options, los atributos extra que se incluyen en la respuesta.
Delete a folder
folder.deleteLo que ves en n8n
Notas y casos de uso
Elimina una carpeta de Box. Que se lleve o no su contenido es una decisión que tomas en el nodo.
Parámetros clave
- Folder ID: la carpeta que se elimina.
- Recursive: desmarcado, una carpeta con contenido no se borra; marcado, se van la carpeta y todo lo que hay dentro. Merece una segunda lectura antes de activar el flujo.
Get a folder
folder.getLo que ves en n8n
Notas y casos de uso
Recupera la ficha de una carpeta y se la pasa al resto del flujo.
Parámetros clave
- Folder ID: la carpeta que se lee. Son los dígitos que Box enseña en la URL, no el nombre con el que la llama el equipo.
Search a folder
folder.searchLo que ves en n8n
Notas y casos de uso
Busca desde el recurso Folder y devuelve lo que encaja, acotando dónde se mira y de quién son los elementos.
Parámetros clave
- Query: el texto que se busca.
- Folder IDs: dentro de Additional Fields, la lista de carpetas donde buscar separadas por comas, que evita que un nombre común saque resultados de toda la cuenta.
- Scope: dentro de Additional Fields, User Content o Enterprise Content.
- Sort: Relevance o Modified At, con Direction en
ASCoDESC.
Share a folder
folder.shareLo que ves en n8n
Notas y casos de uso
Abre una carpeta entera a una persona o a un grupo, y todo lo que hay dentro va detrás.
Parámetros clave
- Folder ID: la carpeta que se comparte.
- Accessible By: User o Group, con Email, User ID o Group ID según Use Email.
- Role: Viewer para lectura, Uploader para solo subir, Editor para lectura y escritura completas, Co-Owner por encima.
- Can View Path: dentro de Options, si la persona invitada ve la ruta padre por encima de la carpeta. No le da ningún permiso ahí arriba, solo visibilidad.
Update a folder
folder.updateLo que ves en n8n
Notas y casos de uso
Cambia los ajustes, el nombre o el sitio de una carpeta sin tocar lo que contiene.
Parámetros clave
- Folder ID: obligatorio, la carpeta que se actualiza.
- Name y Description: dentro de Update Fields, el nombre nuevo y la descripción opcional.
- Parent ID: dentro de Update Fields, un padre nuevo, lo que mueve la carpeta o la saca de la papelera.
- Is Collaboration Restricted To Enterprise: limita las invitaciones nuevas a gente de la empresa, sin tocar las colaboraciones que ya existen.
¿Necesitas ayuda para automatizar Box con n8n?
El equipo te responde directamente.
Cada mensaje lo lee una persona.
