Ressources · Intégration n8n

Intégration Box n8nAutomatiser Box avec n8n.

Les documents dorment dans Box, n8n les met au travail. L'intégration Box n8n, c'est 13 opérations réparties sur 2 ressources, fichiers et dossiers, plus un trigger qui écoute 36 événements classés en 8 familles. Pour les équipes qui classent encore à la main.

Tester l'intégration Box sur n8nVoir les 13 opérations

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

Pourquoi automatiser

À quoi sert l'intégration Box n8n ?

Deux nœuds composent l'intégration Box n8n. Le nœud Box agit sur le compte : il envoie, copie, télécharge, cherche, partage et supprime des fichiers, puis crée, lit, cherche, partage, met à jour et supprime des dossiers. Soit 13 opérations sur 2 ressources. Le Box Trigger fait l'inverse : il démarre un workflow, c'est-à-dire une automatisation enchaînant plusieurs étapes, quand quelque chose bouge dans Box. Il couvre 36 événements groupés en 8 familles, et passe par un webhook, donc l'information arrive en quelques secondes.

Premier réflexe une fois les deux nœuds en place : laisser Box donner le signal. Le Box Trigger s'active, tu coches les événements qui comptent, et le dépôt d'un document devient le point de départ. FILE.UPLOADED se déclenche quand un fichier arrive dans le dossier surveillé, FILE.RENAMED quand quelqu'un le renomme, COLLABORATION.CREATED quand un collaborateur est invité. Un message dans Slack et l'équipe concernée est au courant sans que personne transfère un lien.

Deuxième usage, moins spectaculaire mais très demandé : l'inventaire. file.search interroge le contenu de Box sur un mot, une extension ou une plage de taille, et le champ Return All enchaîne les pages de résultats jusqu'au dernier élément. Le résultat part dans une base Airtable qui devient la table de référence : qui a déposé quoi, dans quel dossier, quand. Plus besoin d'ouvrir Box pour répondre à une question de classement.

Troisième usage : les accès qui se ferment tout seuls. file.share et folder.share créent une collaboration avec un utilisateur ou un groupe, et le champ Role décide de la marge de manœuvre, de Viewer à Co-Owner. Dans la collection Options, Expires At fixe la date à laquelle cette collaboration disparaît d'elle-même. Pour un prestataire embarqué sur trois semaines, c'est la différence entre un accès propre et un accès qu'on oublie de retirer. folder.update vient ensuite renommer ou déplacer le dossier une fois le projet clos.

Deux points à connaître avant de construire. Les recherches sont paginées : Return All décoché, le nœud s'arrête au nombre fixé dans Limit ; coché, n8n remonte toutes les pages. Et ce qui sort des 13 opérations du catalogue passe par le nœud HTTP Request, qui appelle n'importe quel endpoint de l'API Box en réutilisant le même credential via l'authentification prédéfinie.

Pour la suite du workflow, le nœud Gmail reprend le fichier téléchargé et l'envoie en pièce jointe. Et si tu hésites encore sur la plateforme elle-même, l'Avis n8n détaille ce qu'elle fait bien et ce qui coince.

Connexion

Comment connecter Box à n8n ?

  1. 01

    Ouvrir un compte Box et créer une Custom App

    Le seul prérequis, c'est un compte Box. Le credential Box, la fiche d'identification que n8n conserve, s'authentifie en OAuth2 : tu valides l'accès dans le navigateur au lieu de recopier une clé. Pour configurer ce flux toi-même, Box demande de créer une Custom App au préalable et documente chaque étape dans son guide OAuth2. Garde l'onglet ouvert, tu y reviens à l'étape suivante.

  2. 02

    Créer le credential dans n8n

    Dans n8n, menu Credentials, tu crées un credential Box. Il se crée une fois et se réutilise partout : le même authentifie le nœud Box et le Box Trigger, et chaque workflow suivant le choisit dans une liste déroulante. Pas de second credential à prévoir pour le trigger, et rien à coller dans le nœud lui-même. C'est aussi ce qui permet au nœud HTTP Request de réutiliser la connexion.

  3. 03

    Poser le nœud et choisir la ressource

    Ajoute le nœud Box sur le canvas, sélectionne le credential, puis choisis la ressource : File ou Folder. La liste des opérations change avec elle, sept côté fichier et six côté dossier. Côté déclenchement, tu poses le Box Trigger, tu coches les événements voulus dans Events et tu actives le workflow. n8n enregistre alors l'URL du webhook auprès de Box.

Déclencheurs

Qu'est-ce qui déclenche un workflow depuis Box ?

Box Trigger est le nœud qui démarre un workflow quand quelque chose se passe dans Box. Il écoute 36 événements, listés ci-dessous par famille. Tu en choisis un ou plusieurs, tu actives le workflow : n8n enregistre le webhook (l'URL que Box appelle) sur ton compte.

Ce que tu vois dans n8n

Tous les événements, par famille

Une ligne par objet, une puce par action. L'événement à cocher dans le nœud s'écrit objet.action ; survole une puce pour lire quand il se déclenche.

FILE.*11
  • FILE.
    • COPIED
    • DELETED
    • DOWNLOADED
    • LOCKED
    • MOVED
    • PREVIEWED
    • RENAMED
    • RESTORED
    • TRASHED
    • UNLOCKED
    • UPLOADED
FOLDER.*8
  • FOLDER.
    • COPIED
    • CREATED
    • DELETED
    • DOWNLOADED
    • MOVED
    • RENAMED
    • RESTORED
    • TRASHED
COLLABORATION.*5
  • COLLABORATION.
    • ACCEPTED
    • CREATED
    • REJECTED
    • REMOVED
    • UPDATED
COMMENT.*3
  • COMMENT.
    • CREATED
    • DELETED
    • UPDATED
METADATA_INSTANCE.*3
  • METADATA_INSTANCE.
    • CREATED
    • DELETED
    • UPDATED
SHARED_LINK.*3
  • SHARED_LINK.
    • CREATED
    • DELETED
    • UPDATED
TASK_ASSIGNMENT.*2
  • TASK_ASSIGNMENT.
    • CREATED
    • UPDATED
WEBHOOK.*1
  • WEBHOOK.
    • DELETED

Notes de configuration

01Configure the Box TriggerLe Box Trigger démarre un workflow quand un événement se produit dans Box. Il repose sur un webhook, une URL que Box appelle au moment où ça arrive : l'événement parvient à n8n en quelques secondes, sans interrogation régulière. n8n enregistre cette URL auprès de Box à l'activation du workflow.

Le Box Trigger démarre un workflow quand un événement se produit dans Box. Il repose sur un webhook, une URL que Box appelle au moment où ça arrive : l'événement parvient à n8n en quelques secondes, sans interrogation régulière. n8n enregistre cette URL auprès de Box à l'activation du workflow.

Paramètres clés

  • Events : la liste des événements écoutés. Un seul, une famille entière, ou les 36. Aucun joker ne couvre tout, donc un événement non coché ne déclenchera jamais rien.
  • Target Type : si l'élément surveillé est un fichier ou un dossier.
  • Target ID : l'identifiant Box de cet élément, qui restreint l'écoute à un fichier ou un dossier précis plutôt qu'au compte entier.
Quand l'utiliser
dès que Box est l'endroit où le travail apparaît en premier, boîte de dépôt, dossier client, arborescence de livrables.
02File eventsLa famille la plus fournie, 11 événements, suit un document de bout en bout. FILE.UPLOADED se déclenche quand un fichier est déposé dans le dossier surveillé ou y est déplacé : c'est la porte d'entrée naturelle d'un workflow de réception. FILE.COPIED, FILE.MOVED et FILE.RENAMED signalent un document qui change de place ou de nom.

La famille la plus fournie, 11 événements, suit un document de bout en bout. FILE.UPLOADED se déclenche quand un fichier est déposé dans le dossier surveillé ou y est déplacé : c'est la porte d'entrée naturelle d'un workflow de réception. FILE.COPIED, FILE.MOVED et FILE.RENAMED signalent un document qui change de place ou de nom.

FILE.TRASHED et FILE.DELETED correspondent tous deux à une mise à la corbeille, FILE.RESTORED à la sortie de corbeille. Restent trois événements qui parlent des gens plutôt que du stockage : FILE.PREVIEWED et FILE.DOWNLOADED disent qu'un document a été réellement ouvert ou emporté, FILE.LOCKED et FILE.UNLOCKED qu'un verrou d'édition a été posé ou levé.

Quand l'utiliser
chaînes de réception, traçabilité sur les documents sensibles, et tout process où l'arrivée d'un fichier donne le départ.
03Folder eventsHuit événements reprennent la même logique un cran au-dessus. FOLDER.CREATED se déclenche à la création d'un dossier, souvent le premier signe qu'un client, un projet ou un dossier d'affaire vient de démarrer. FOLDER.COPIED, FOLDER.MOVED et FOLDER.RENAMED suivent les réorganisations, celles qui cassent discrètement les liens enregistrés par tout le monde.

Huit événements reprennent la même logique un cran au-dessus. FOLDER.CREATED se déclenche à la création d'un dossier, souvent le premier signe qu'un client, un projet ou un dossier d'affaire vient de démarrer. FOLDER.COPIED, FOLDER.MOVED et FOLDER.RENAMED suivent les réorganisations, celles qui cassent discrètement les liens enregistrés par tout le monde.

Trois événements distinguent trois situations différentes : FOLDER.TRASHED pour la mise à la corbeille, FOLDER.DELETED pour la suppression définitive, FOLDER.RESTORED pour le retour en arrière. La nuance compte quand le workflow d'en face doit choisir entre prévenir quelqu'un et annuler quelque chose. FOLDER.DOWNLOADED complète la famille, quand un dossier entier est téléchargé.

Quand l'utiliser
garder un suivi de projet aligné sur l'arborescence, et repérer les changements de structure avant les premiers signalements.
04Collaboration and shared link eventsCes deux familles, 5 et 3 événements, forment le versant accès de Box. Côté collaboration, COLLABORATION.CREATED marque l'invitation envoyée, COLLABORATION.ACCEPTED et COLLABORATION.REJECTED la réponse de la personne invitée, COLLABORATION.UPDATED un changement de niveau d'accès, COLLABORATION.REMOVED un accès retiré.

Ces deux familles, 5 et 3 événements, forment le versant accès de Box. Côté collaboration, COLLABORATION.CREATED marque l'invitation envoyée, COLLABORATION.ACCEPTED et COLLABORATION.REJECTED la réponse de la personne invitée, COLLABORATION.UPDATED un changement de niveau d'accès, COLLABORATION.REMOVED un accès retiré.

Les liens partagés fonctionnent pareil, avec une portée plus large : SHARED_LINK.CREATED, SHARED_LINK.UPDATED et SHARED_LINK.DELETED se déclenchent quand un lien vers un document est créé, modifié ou supprimé. Un lien partagé va plus loin qu'une collaboration, donc c'est souvent celui qu'on surveille en premier.

Quand l'utiliser
pour une revue d'accès qui ne dépend plus de la mémoire de quelqu'un. Chacun de ces huit événements atterrit dans un workflow capable de le journaliser, de le poster dans un canal, ou de demander à un humain de confirmer que l'accès était bien voulu. La réponse arrive tant que le contexte est frais, pas au moment du point trimestriel.
05Comment, metadata, task and webhook eventsQuatre familles plus petites ferment la liste, 9 événements à elles quatre. Les commentaires en apportent 3 : COMMENT.CREATED, COMMENT.UPDATED et COMMENT.DELETED, utiles quand la relecture se passe dans Box plutôt que par mail.

Quatre familles plus petites ferment la liste, 9 événements à elles quatre. Les commentaires en apportent 3 : COMMENT.CREATED, COMMENT.UPDATED et COMMENT.DELETED, utiles quand la relecture se passe dans Box plutôt que par mail.

Les instances de métadonnées en apportent 3 autres. METADATA_INSTANCE.CREATED se déclenche quand un modèle de métadonnées est associé à un fichier ou un dossier, METADATA_INSTANCE.UPDATED quand une de ses valeurs change, METADATA_INSTANCE.DELETED quand l'instance disparaît. Si l'équipe classe ses documents avec des modèles, c'est cette famille qui porte le signal.

Les assignations de tâche en apportent 2, TASK_ASSIGNMENT.CREATED et TASK_ASSIGNMENT.UPDATED. Et WEBHOOK.DELETED reste seul : il se déclenche quand un webhook est supprimé, le seul événement qui prévient que la tuyauterie elle-même a sauté.

Quand l'utiliser
quand l'intérêt d'un document n'est pas le fichier mais ce qu'on a écrit dessus, la façon dont il a été classé, ou la personne à qui on a demandé d'agir. En recomptant les huit familles, 11 plus 8 plus 5 plus 3 plus 3 plus 3 plus 2 plus 1, on retombe bien sur les 36 événements que le trigger sait écouter.
Actions

Que sait faire le nœud Box ?

Le nœud Box expose 13 opérations sur 2 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
RessourceCreateGetUpdateDeleteCopyDownloadSearchShareUpload
File✓✓✓✓✓✓✓
Folder✓✓✓✓✓✓

File

7 opérations
01

Copy a file

file.copy

Ce que tu vois dans n8n

Notes & cas d'usage

Duplique un fichier dans un autre dossier et renvoie la copie. L'original ne bouge pas.

Paramètres clés

  • File ID : requis, l'identifiant Box du fichier à dupliquer.
  • Parent ID : le dossier de destination. Laissé vide, la copie atterrit à la racine, ce qui est rarement l'intention.
  • Name : dans Additional Fields, un nouveau nom pour la copie, la façon propre d'éviter deux fichiers homonymes.
  • Version : dans Additional Fields, l'identifiant d'une version précise à copier plutôt que la version courante.
Cas d'usage
le contrat signé reste dans le dossier commercial pendant qu'une copie renommée part vers la compta, qui n'ouvrira plus le brouillon par erreur.
02

Delete a file

file.delete

Ce que tu vois dans n8n

Notes & cas d'usage

Retire un fichier de Box depuis le workflow, et le ménage cesse d'être une corvée de fin de semaine.

Paramètres clés

  • File ID : le fichier à retirer. Le champ attend l'identifiant Box, pas le nom du fichier, donc récupère-le d'une étape Get ou Search placée avant.
Cas d'usage
chaque nuit, un workflow vide les exports temporaires déposés par un job de reporting, et le dossier partagé reste lisible pour ceux qui y travaillent le matin.
03

Download a file

file.download

Ce que tu vois dans n8n

Notes & cas d'usage

Récupère le contenu du fichier dans le workflow sous forme de données binaires, prêtes pour le nœud suivant.

Paramètres clés

  • Put Output File in Field : requis, le nom du champ binaire de sortie où le fichier est déposé. Ce que tu écris ici, c'est ce que le nœud suivant devra viser.
  • File ID : quel fichier récupérer.
Cas d'usage
le relevé mensuel stocké dans Box est téléchargé, mis en pièce jointe et envoyé au client, sans que personne ouvre Box.
04

Get a file

file.get

Ce que tu vois dans n8n

Notes & cas d'usage

Lit les informations d'un fichier et les renvoie dans le workflow. C'est l'étape de consultation, pas celle du contenu.

Paramètres clés

  • File ID : le fichier à lire.
  • Fields : dans Additional Fields, une liste d'attributs séparés par des virgules à inclure dans la réponse. Elle sert aussi à demander des attributs qu'une réponse standard ne renvoie pas.
Cas d'usage
après un déclenchement sur un document, cette étape rassemble ses informations avant qu'un nœud IF décide si le workflow continue ou s'arrête là.
06

Share a file

file.share

Ce que tu vois dans n8n

Notes & cas d'usage

Donne à quelqu'un l'accès à un fichier précis en créant une collaboration dessus.

Paramètres clés

  • File ID : le fichier à partager.
  • Accessible By : un utilisateur (User) ou un groupe (Group).
  • Use Email : coché, la personne est identifiée par Email ; décoché, par User ID. Un groupe passe par Group ID.
  • Role : le niveau accordé, de Viewer ou Previewer jusqu'à Editor et Co-Owner, avec les variantes Uploader pour un accès en dépôt.
  • Expires At : dans Options, la date à laquelle la collaboration est retirée automatiquement.
  • Notify : si la personne reçoit un email.
Cas d'usage
un relecteur externe obtient un accès Previewer sur un seul brief, qui s'éteint à la fin du sprint.
07

Upload a file

file.upload

Ce que tu vois dans n8n

Notes & cas d'usage

Dépose un nouveau fichier dans Box, à partir de données binaires transportées par le workflow ou d'un texte construit plus tôt.

Paramètres clés

  • Binary File : requis, indique si les données viennent d'un champ binaire ou d'un texte.
  • Input Binary Field : requis quand Binary File est coché, le nom du champ binaire d'entrée qui contient le fichier.
  • File Content : requis quand Binary File est décoché, le contenu texte du fichier.
  • File Name : le nom sous lequel enregistrer, par exemple photo.png.
  • Parent ID : le dossier d'arrivée. Sans lui, la racine.
Cas d'usage
une facture extraite d'une boîte mail atterrit dans le dossier du mois.

Folder

6 opérations
08

Create a folder

folder.create

Ce que tu vois dans n8n

Notes & cas d'usage

Crée un dossier et le renvoie : le workflow construit lui-même son rangement au fil de l'eau.

Paramètres clés

  • Name : requis, le nom du dossier.
  • Parent ID : le dossier parent. Laissé vide, la création se fait à la racine.
  • Access : dans Options, Collaborators n'accepte que les adresses de collaborateurs enregistrés, Open accepte n'importe quelle adresse.
  • Fields : dans Options, les attributs supplémentaires à inclure dans la réponse.
Cas d'usage
une affaire créée dans le CRM déclenche son arborescence Box dans la minute, nommée d'après l'affaire, pour que le premier document ait déjà sa place.
09

Delete a folder

folder.delete

Ce que tu vois dans n8n

Notes & cas d'usage

Supprime un dossier de Box. Emporter ou non son contenu, c'est un choix qui se fait dans le nœud.

Paramètres clés

  • Folder ID : le dossier à supprimer.
  • Recursive : décoché, un dossier non vide n'est pas supprimé ; coché, le dossier et tout son contenu partent. Relis ce paramètre deux fois avant d'activer le workflow.
Cas d'usage
l'arborescence de test créée pour une recette est démontée en fin de recette, en récursif, pour ne rien laisser derrière.
10

Get a folder

folder.get

Ce que tu vois dans n8n

Notes & cas d'usage

Va chercher la fiche d'un dossier et la transmet à la suite du workflow.

Paramètres clés

  • Folder ID : le dossier à lire. Ce sont les chiffres que Box affiche dans l'URL, pas le nom que l'équipe lui donne.
Cas d'usage
avant un dépôt, le workflow vérifie que le dossier cible existe toujours, puis bascule vers Create a folder si ce n'est plus le cas. C'est aussi le moyen le plus rapide de confirmer qu'un credential a bien accès à l'arborescence visée.
12

Share a folder

folder.share

Ce que tu vois dans n8n

Notes & cas d'usage

Ouvre un dossier entier à une personne ou à un groupe, et tout ce qu'il contient suit.

Paramètres clés

  • Folder ID : le dossier à partager.
  • Accessible By : User ou Group, avec Email, User ID ou Group ID selon Use Email.
  • Role : Viewer pour la lecture, Uploader pour le dépôt seul, Editor pour lecture et écriture complètes, Co-Owner au-dessus.
  • Can View Path : dans Options, si la personne invitée voit le chemin parent au-dessus du dossier. Ça ne donne aucun droit dessus, seulement de la visibilité.
Cas d'usage
l'arrivée d'un prestataire donne à son groupe un accès Viewer sur le dossier de documentation dès le premier jour.
13

Update a folder

folder.update

Ce que tu vois dans n8n

Notes & cas d'usage

Modifie les réglages, le nom ou la place d'un dossier sans toucher à ce qu'il contient.

Paramètres clés

  • Folder ID : requis, le dossier à mettre à jour.
  • Name et Description : dans Update Fields, le nouveau nom et la description facultative.
  • Parent ID : dans Update Fields, un nouveau parent, ce qui déplace le dossier ou le fait ressortir de la corbeille.
  • Is Collaboration Restricted To Enterprise : limite les nouvelles invitations aux personnes de l'entreprise, sans toucher aux collaborations en cours.
Cas d'usage
un dossier de projet terminé est renommé avec sa date de fin et rangé sous un parent d'archives, en une seule étape.
Besoin d'aide

Besoin d'aide pour automatiser Box avec n8n ?

L'équipe te répond directement.

Chaque message est lu par une personne.

FAQ

Box et n8n, les questions qui reviennent

01L'intégration Box n8n est-elle gratuite ?
Oui du côté n8n. Le nœud Box et le Box Trigger sont livrés avec n8n : rien à installer, rien à payer en plus pour le connecteur lui-même. C'est vrai sur n8n Cloud, l'offre hébergée par n8n, comme sur une instance auto-hébergée en Community Edition sous licence Sustainable Use. Un workflow se comporte de la même façon des deux côtés, donc tu peux le construire sur l'un et le déplacer sur l'autre sans le réécrire. Ce que coûte le compte Box lui-même est une autre question, elle dépend de ton offre chez Box et cette page ne la traite pas.
02Quels credentials faut-il pour connecter Box à n8n ?
Un compte Box et un credential Box dans n8n, authentifié en OAuth2. C'est la seule méthode d'authentification prise en charge ici : pas de champ pour une clé API, tu valides l'accès chez Box dans le navigateur et n8n conserve la connexion. Pour mettre ce flux en place depuis zéro, Box demande de créer une Custom App et documente chaque étape du parcours OAuth sur le web. Un seul credential couvre les deux nœuds, le nœud Box et le Box Trigger, et chaque workflow suivant le sélectionne dans une liste au lieu de refaire la configuration.
03Quelles sont les limites du nœud Box dans n8n ?
Deux choses cadrent ce que tu récupères. D'abord la pagination des recherches : Return All décoché, le nœud s'arrête au nombre inscrit dans Limit ; coché, n8n redemande des pages jusqu'à ce que tout soit remonté, ce qui est indispensable pour un export complet et déconseillé au milieu d'une boucle. Ensuite le périmètre : le nœud expose 13 opérations sur les fichiers et les dossiers. Ce qui sort de ces opérations passe par le nœud HTTP Request, qui appelle n'importe quel endpoint de l'API Box en réutilisant le même credential via l'authentification prédéfinie. Tout reste donc dans le même workflow.
04Le Box Trigger réagit-il en temps réel ?
Oui, il fonctionne par webhook, c'est-à-dire une URL que Box appelle au moment où l'événement se produit. Le workflow démarre en quelques secondes. n8n enregistre cette URL auprès de Box à l'activation du workflow : aucune fréquence à régler, aucun intervalle à ajuster. Tu choisis lesquels des 36 événements écouter dans le champ Events, et tu peux restreindre la surveillance à un seul élément avec Target Type et Target ID. Aucun joker ne couvre tout, donc un événement non coché ne déclenchera rien. Bon à savoir le jour où un déclenchement attendu ne vient pas.
05n8n ou Make pour automatiser Box ?
Ça dépend d'où tu veux faire tourner le workflow et de la façon dont tu veux le payer. Make est une plateforme hébergée, sans option d'auto-hébergement, facturée à l'opération : la facture suit le volume. n8n tourne sur Cloud ou sur ton propre serveur via Docker ou npm, et le workflow est identique dans les deux cas, ce qui pèse quand les documents contiennent des données clients que tu préfères garder sur une infrastructure que tu maîtrises. Les deux offrent une logique visuelle. Volume faible et stable, la facturation à l'opération reste simple. Volume qui grimpe ou données sensibles, l'auto-hébergement change le calcul.
Même plateforme

Autres docs utiles sur ce stack.

Voir toutes les intégrations