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
À 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.
Comment connecter NocoDB à n8n ?
- 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. - 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:8080sur 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. - 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.
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.
| Ressource | Create | Get | Get Many | Update | Delete | Count | Link | List | Search | Unlink | Upload Attachment to Cell | Create or Update |
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Row | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ||||
| Linked Row | ✓ | ✓ | ✓ | |||||||||
| Base | ✓ | ✓ |
Sommaire des opérations
Row
8 opérationsCreate a row
row.createCe 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 ;mapWithFieldste laisse remplir chaque colonne, et Inputs to Ignore écarte les propriétés que tu ne veux pas stocker.
Create or update a row
row.upsertCe 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.
Update a row
row.updateCe 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.
Delete a row
row.deleteCe 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.
Get a row
row.getCe 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.
Search rows
row.searchCe que tu vois dans n8n
Notes & cas d'usage
Renvoie les lignes qui correspondent à un filtre, ou toute la table quand aucun filtre n'est posé. C'est l'opération sur laquelle repose tout workflow planifié, puisque NocoDB n'a pas de nœud trigger.
Paramètres clés
- Return All : activé, n8n parcourt toutes les pages de résultats ; désactivé, il s'arrête à Limit.
- Filter By Formula : la syntaxe de filtre NocoDB, de la forme
(name,like,example%)~or(name,eq,test). - View Name or ID, Fields, Sort, Page et Shuffle : rangés sous Options, pour lire une vue enregistrée, réduire les colonnes renvoyées, trier ou sauter des pages.
Count rows
row.countCe 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.
Upload attachment to a row cell
row.uploadCe 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 :
urlpour laisser NocoDB aller chercher le fichier à une adresse publique,base64pour 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.
Linked Row
3 opérationsGet linked rows
linkrow.listCe 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.
Link a row
linkrow.linkCe que tu vois dans n8n
Notes & cas d'usage
Rattache un enregistrement à un autre via un champ relationnel. Les deux lignes existent déjà, l'opération ne fait que tracer le lien entre elles.
Paramètres clés
- Row ID Value : l'enregistrement qui porte le champ de liaison.
- Linked Row ID Value : l'enregistrement rattaché. Les deux sont des identifiants, jamais des noms, et c'est l'erreur qui fait échouer la première exécution.
- Link Field Name or ID : la colonne relationnelle qui porte la relation.
Unlink a row
linkrow.unlinkCe que tu vois dans n8n
Notes & cas d'usage
Casse la relation entre deux enregistrements sans supprimer ni l'un ni l'autre. Les lignes restent dans leurs tables, seule la liaison disparaît.
Paramètres clés
- Link Field Name or ID : la colonne relationnelle qui contient la liaison à retirer.
- Row ID Value et Linked Row ID Value : les deux extrémités de la relation, dans le même ordre que pour le rattachement.
Base
2 opérationsGet many bases
base.getAllCe 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.
Get one base
base.getCe 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.
Besoin d'aide pour automatiser NocoDB avec n8n ?
L'équipe te répond directement.
Chaque message est lu par une personne.


