Ressources · Intégration n8n

Intégration NocoDB n8nAutomatiser NocoDB avec n8n.

NocoDB garde les tables, n8n fait circuler ce qu'il y a autour. L'intégration NocoDB n8n couvre 13 opérations sur 3 ressources : les lignes, les lignes liées et les bases. Aucun nœud trigger n'est livré, le workflow part donc d'un horaire ou d'un appel extérieur.

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

Pourquoi automatiser

À quoi sert l'intégration NocoDB n8n ?

Le nœud NocoDB transforme tes tables en point de lecture et d'écriture pour n'importe quel workflow, c'est-à-dire n'importe quelle suite d'étapes automatisées dans n8n. Il couvre 13 opérations sur 3 ressources : les lignes (création, upsert, mise à jour, suppression, lecture, recherche, comptage, envoi de pièce jointe), les lignes liées (liste, lien, retrait du lien) et les bases (une base, toutes les bases). Tout passe par ton instance, et le même nœud fonctionne sur n8n Cloud comme sur une instance installée chez toi.

Premier usage : la collecte. Une agence immobilière récupère les demandes de visite envoyées depuis un formulaire, et le workflow les écrit une à une dans la table des dossiers ouverts avec row.create. La ligne repart aussitôt avec l'identifiant que NocoDB vient de générer, prête à être reliée à un bien ou à un agent dans une étape suivante.

Deuxième usage : garder deux systèmes d'accord. row.search ramène les lignes qui correspondent à un filtre, row.count donne la taille d'un lot avant d'écrire quoi que ce soit, et row.upsert règle la question des doublons : identifiant rempli, la ligne est modifiée ; identifiant vide, elle est créée. C'est comme ça qu'une facturation qui vit dans Postgres retrouve son miroir dans NocoDB pour l'équipe qui préfère une interface tableur, sans recopie nocturne.

Troisième usage : le relationnel. NocoDB relie des enregistrements entre tables, et les opérations de lignes liées rendent ça pilotable : lister ce qu'une ligne pointe, y rattacher un autre enregistrement, le détacher quand le statut change. Pour un export ponctuel vers la compta, ces lignes liées repartent aussi bien vers Microsoft Excel 365 qu'ailleurs. Pour des requêtes lourdes ou des jointures, un nœud base de données comme Supabase reste plus adapté, et rien n'empêche de faire cohabiter les deux dans un même workflow. L'Avis n8n détaille ce partage des rôles.

Deux limites avant de construire. Il n'existe pas de nœud trigger NocoDB : une modification faite dans la table ne lance rien toute seule. Le workflow démarre sur un Schedule Trigger, qui se déclenche à intervalle fixe, ou sur un Webhook n8n, une URL qu'un service extérieur vient appeler. Et le nœud s'arrête à ces 13 opérations : pour le reste de l'API NocoDB, le nœud HTTP Request appelle l'endpoint directement en réutilisant le même credential, la connexion enregistrée une fois dans n8n.

Connexion

Comment connecter NocoDB à n8n ?

  1. 01

    Générer un token d'API dans NocoDB

    Connecte-toi à NocoDB, ouvre le menu utilisateur en bas à gauche, puis Account Settings. Va dans l'onglet Tokens et choisis Add new API token. Donne-lui un nom qui dit où il sert, par exemple n8n integration, puis enregistre. Copie le token tout de suite : c'est la valeur que n8n enverra à chaque appel, et NocoDB est le seul endroit où elle existe.

  2. 02

    Créer le credential côté n8n

    Dans n8n, ouvre le menu Credentials et crée un credential NocoDB API Token, la méthode recommandée. Deux champs : l'API Token que tu viens de copier et le Host de ton instance, l'adresse de base à laquelle NocoDB répond, par exemple http://localhost:8080 sur une installation locale. Le credential se crée une fois et réapparaît ensuite dans la liste déroulante de tous les nœuds NocoDB.

  3. 03

    Choisir une base et une table dans le nœud

    Pose un nœud NocoDB dans un workflow, sélectionne la ressource et l'opération, puis ouvre Base Name or ID. Si le credential fonctionne, la liste se remplit avec tes bases, et Table Name or ID se remplit à son tour une fois la base choisie. Cette liste qui se charge est le test de connexion le plus rapide. Quand la base change d'une exécution à l'autre, bascule le champ en expression plutôt qu'en sélection.

Actions

Que sait faire le nœud NocoDB ?

Le nœud NocoDB expose 13 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
RessourceCreateGetGet ManyUpdateDeleteCountLinkListSearchUnlinkUpload Attachment to CellCreate or Update
Row✓✓✓✓✓✓✓✓
Linked Row✓✓✓
Base✓✓

Row

8 opérations
01

Create a row

row.create

Ce que tu vois dans n8n

Notes & cas d'usage

Écrit une nouvelle ligne dans la table choisie et la renvoie avec l'identifiant que NocoDB vient d'attribuer, directement exploitable par le nœud suivant.

Paramètres clés

  • Base Name or ID : choisi dans la liste, ou défini par une expression, la petite formule n8n qui lit l'élément entrant.
  • Table Name or ID : la table visée, proposée une fois la base sélectionnée.
  • Fields to Send : le mappage des colonnes. Avec Data to Send sur autoMapInputData, les propriétés entrantes tombent dans les colonnes du même nom ; mapWithFields te laisse remplir chaque colonne, et Inputs to Ignore écarte les propriétés que tu ne veux pas stocker.
Cas d'usage
un formulaire d'inscription dépose une ligne par candidat dans la table que le bureau consulte.
02

Create or update a row

row.upsert

Ce que tu vois dans n8n

Notes & cas d'usage

Une seule opération pour les deux cas : la ligne existe et elle est mise à jour, elle n'existe pas et elle est créée. La logique de dédoublonnage sort du workflow.

Paramètres clés

  • Row ID Value : le champ qui décide. Rempli, NocoDB met à jour la ligne correspondante ; laissé vide, il en insère une nouvelle, exactement ce que produit {{ $json.id }} quand l'étape précédente trouve parfois une correspondance et parfois rien.
  • Fields to Send : les colonnes écrites dans les deux branches, mappées automatiquement ou une par une selon Data to Send.
Cas d'usage
un import quotidien rafraîchit les références déjà présentes et ajoute les nouvelles, dans un seul nœud.
03

Update a row

row.update

Ce que tu vois dans n8n

Notes & cas d'usage

Modifie les colonnes que tu mappes sur une ligne existante. Les colonnes absentes du mappage gardent leur valeur, donc un workflow peut posséder un champ sans toucher au reste de la ligne.

Paramètres clés

  • Row ID Value : obligatoire ici. NocoDB attend l'identifiant de l'enregistrement, pas son nom ni son libellé, et la valeur vient le plus souvent d'une recherche faite juste avant.
  • Fields to Send : uniquement les colonnes à réécrire, avec Inputs to Ignore en garde-fou quand l'élément entrant transporte plus de propriétés que la table n'en attend.
Cas d'usage
une colonne de statut passe à Payé dès que le paiement est confirmé en amont.
04

Delete a row

row.delete

Ce que tu vois dans n8n

Notes & cas d'usage

Supprime un enregistrement de la table. Pas de confirmation, pas de retour en arrière dans le workflow, ce qui rend le nœud qui l'alimente plus critique que l'opération elle-même.

Paramètres clés

  • Row ID Value : l'identifiant de la ligne à retirer, en général {{ $json.Id }} issu d'une recherche placée juste avant.
  • Base Name or ID et Table Name or ID : à revérifier quand plusieurs bases contiennent des tables qui portent le même nom.
Cas d'usage
un ménage hebdomadaire retire les lignes de test accumulées dans une table de recette.
05

Get a row

row.get

Ce que tu vois dans n8n

Notes & cas d'usage

Va chercher un enregistrement précis par son identifiant et renvoie ses colonnes en un élément. C'est la façon la moins coûteuse de rafraîchir une donnée dont tu connais déjà la référence.

Paramètres clés

  • Row ID Value : l'identifiant de la ligne à lire.
  • Download Field Names or IDs : les colonnes de pièces jointes à récupérer. La liste ne propose que les champs de type attachment.
  • Download Attachments : désactivé, tu reçois les informations du fichier ; activé, n8n télécharge les fichiers nommés au-dessus en données binaires, prêtes à repartir en pièce jointe.
Cas d'usage
un workflow de support lit la ligne de contrat liée au ticket et joint le document signé à la réponse.
07

Count rows

row.count

Ce que tu vois dans n8n

Notes & cas d'usage

Retourne le nombre de lignes qui correspondent, sans faire transiter les lignes elles-mêmes. Pratique avant une écriture, et assez léger pour tourner à intervalle court.

Paramètres clés

  • Table Name or ID : la table à mesurer, dans la base sélectionnée juste au-dessus.
  • Filter By Formula : sous Options, la même syntaxe que la recherche, ce qui transforme le comptage en indicateur sur un segment plutôt que sur toute la table.
Cas d'usage
un nœud IF compare le nombre de lignes non traitées à 0 et arrête le workflow quand il n'y a rien à faire.
08

Upload attachment to a row cell

row.upload

Ce que tu vois dans n8n

Notes & cas d'usage

Dépose un ou plusieurs fichiers dans une cellule de type pièce jointe d'une ligne existante. Le document vit à côté de l'enregistrement, pas dans un dossier séparé.

Paramètres clés

  • Upload Mode : url pour laisser NocoDB aller chercher le fichier à une adresse publique, base64 pour pousser le contenu fourni par une étape précédente.
  • Upload Field Name or ID : la colonne de pièces jointes qui reçoit le fichier.
  • Filename et Content Type : le nom stocké dans NocoDB et le type, par exemple image/jpeg.
  • Base64 Value ou File Url : le fichier lui-même, selon le mode retenu.
Cas d'usage
le devis signé rejoint la ligne du client qui l'a renvoyé.

Linked Row

3 opérations
09

Get linked rows

linkrow.list

Ce que tu vois dans n8n

Notes & cas d'usage

Lit ce qu'un enregistrement pointe via un champ de liaison et renvoie les enregistrements liés en éléments distincts. Ça répond à la question qu'une lecture simple laisse ouverte : qu'est-ce qui est rattaché à cette ligne ?

Paramètres clés

  • Row ID Value : l'enregistrement dont tu lis les liaisons.
  • Link Field Name or ID : la colonne relationnelle à suivre, proposée dans la liste des champs de type link.
  • Return All et Limit : le même choix de pagination qu'ailleurs, avec Fields, Sort et Filter By Formula disponibles sous Options.
Cas d'usage
lister les commandes rattachées à une fiche client avant de construire un récapitulatif.

Base

2 opérations
12

Get many bases

base.getAll

Ce que tu vois dans n8n

Notes & cas d'usage

Liste les bases accessibles au token, avec leurs identifiants. Beaucoup de workflows n'en ont jamais besoin ; ceux qui en ont besoin s'en servent pour découvrir où écrire au lieu de figer la base dans le nœud.

Paramètres clés

  • Workspace Name or ID : facultatif, et seul réglage disponible. Laissé vide, le nœud renvoie ce que le credential peut voir.
Cas d'usage
un workflow d'inventaire liste les bases, puis boucle sur chacune pour compter les lignes et remonter les totaux.
13

Get one base

base.get

Ce que tu vois dans n8n

Notes & cas d'usage

Récupère une base et ses informations. C'est surtout une étape de résolution : tu tiens un identifiant, tu veux l'objet qui va avec.

Paramètres clés

  • Base Name or ID : le seul champ obligatoire, choisi dans la liste ou fourni par une expression quand l'identifiant arrive d'une étape précédente.
Cas d'usage
un workflow qui reçoit un identifiant de base dans un appel entrant le résout d'abord, puis décide si la suite doit s'exécuter.
Besoin d'aide

Besoin d'aide pour automatiser NocoDB avec n8n ?

L'équipe te répond directement.

Chaque message est lu par une personne.

FAQ

NocoDB et n8n : les questions fréquentes

01L'intégration NocoDB n8n est-elle gratuite ?
Oui côté n8n. Le nœud NocoDB est livré avec n8n : rien à installer, aucun coût supplémentaire pour le connecteur lui-même. Il se comporte de la même façon sur n8n Cloud, l'offre hébergée par n8n, et sur une instance auto-hébergée installée avec Docker ou npm, en Community Edition sous licence Sustainable Use. Un workflow construit d'un côté tourne de l'autre sans modification. Ce que coûte ton instance NocoDB dépend de la façon dont tu l'exploites, et cette page ne traite pas ce point. Il faut simplement un host joignable et un token valide.
02Quels credentials faut-il pour le nœud NocoDB ?
Deux méthodes existent, une seule est recommandée. Avec la méthode API Token, tu crées un jeton dans NocoDB via Account Settings puis l'onglet Tokens, et tu le saisis dans n8n avec le Host de ton instance, par exemple une adresse locale sur le port 8080. La seconde méthode, User Token, s'appuie sur le jeton de session. NocoDB l'avait prévu pour des essais rapides sur l'API, il reste valable jusqu'à la déconnexion ou pendant 10 heures, et NocoDB l'a déprécié en v0.205.1. Prends le token d'API. Le credential est enregistré une fois dans n8n et se sélectionne ensuite dans une liste.
03Quelles sont les limites du nœud NocoDB ?
Le nœud expose 13 opérations sur 3 ressources, ce qui couvre les lignes, les lignes liées et les bases, et rien d'autre de l'API NocoDB. Une vue se lit via l'opération de recherche, mais aucune opération ne crée une table, une colonne ou une vue. Les lectures sont paginées : avec Return All désactivé, la recherche et la liste des lignes liées s'arrêtent à Limit, donc un export qui paraît incomplet vient presque toujours de ce réglage. Pour tout endpoint non couvert, le nœud HTTP Request appelle l'API directement en réutilisant le même credential.
04Comment déclencher un workflow n8n depuis NocoDB ?
Pas depuis NocoDB directement. Il n'existe pas de nœud trigger NocoDB, donc une modification faite dans une table ne lance aucun workflow d'elle-même. Deux approches remplacent ça. La première : un Schedule Trigger, qui se déclenche à intervalle fixe, suivi d'une opération de recherche filtrée sur une colonne de statut, pour que le workflow ramasse ce qui est apparu depuis le passage précédent et marque les lignes traitées. La seconde : un Webhook n8n, une URL que ton propre outil appelle au moment voulu, qui lit ou écrit la ligne dans la foulée. Les deux tiennent la route, la première n'est simplement pas instantanée.
05n8n ou Make pour NocoDB ?
Quatre critères tranchent. L'hébergement : n8n s'auto-héberge avec Docker ou npm, Make est uniquement hébergé, ce qui règle la question quand les données doivent rester sur tes serveurs, à côté de ton instance NocoDB. Le modèle de coût : Make facture à l'opération, donc un workflow qui parcourt des milliers de lignes ne pèse pas du tout pareil sur la facture. La maîtrise : en auto-hébergé, les credentials et l'historique des exécutions restent chez toi. La logique visuelle : les deux sont des éditeurs visuels, et Make se prend en main un peu plus vite sur des scénarios linéaires. Aucun des deux n'est un mauvais choix.