Comment connecter n8n à Supabase pour stocker vos données ?
Connecter n8n à Supabase consiste à renseigner l’URL du projet et une clé API Supabase dans les identifiants n8n, puis à utiliser le node Supabase pour lire, insérer, mettre à jour ou supprimer des lignes dans une base Postgres depuis un workflow. Aucune requête SQL manuelle n’est nécessaire pour les opérations courantes.
Ajoutez vos identifiants Supabase dans les credentials n8n, glissez le node Supabase dans un workflow, choisissez une opération (Create, Get, Update, Delete) et mappez les champs de votre table.
Pourquoi connecter n8n à Supabase ?
Supabase propose une base de données Postgres hébergée, accessible via une API REST générée automatiquement. n8n dispose d’un node dédié qui s’appuie sur cette API : il n’est pas nécessaire d’écrire une requête SQL pour lire ou écrire une ligne.
Cette connexion est utile dès qu’un workflow doit se souvenir de quelque chose : un lead déjà contacté, l’historique d’une conversation, l’état d’avancement d’un dossier ou le contexte d’un agent IA. Sans base de données, un workflow oublie tout entre deux exécutions.
La documentation Supabase décrit ce fonctionnement : chaque table Postgres reçoit automatiquement un point d’accès API, sécurisé par des clés et des règles de sécurité au niveau des lignes (RLS).
Quels prérequis avant de commencer ?
Avant de brancher les deux outils, il faut réunir trois éléments :
Créé gratuitement sur supabase.com, avec au moins une table déjà en place.
Cloud ou auto-hébergée : la connexion Supabase fonctionne à l’identique sur les deux.
Pour récupérer l’URL et la clé API dans les paramètres du projet Supabase.
Si votre instance n8n n’est pas encore installée, notre guide sur l’installation de n8n en auto-hébergé détaille les étapes VPS, Docker et Hostinger.
Comment créer les identifiants API dans Supabase ?
Les identifiants se récupèrent directement dans le tableau de bord Supabase, sans configuration supplémentaire côté base de données.
- Ouvrir Project Settings puis APIDans le menu latéral du projet Supabase concerné.
- Copier l’URL du projetElle ressemble à https://xxxxx.supabase.co et sert d’adresse pour toutes les requêtes.
- Copier la clé API adaptéeLa clé
anonrespecte les règles RLS ; la cléservice_roleles contourne entièrement. - Vérifier les règles RLS de la table cibleUne table avec RLS activé sans politique définie refusera toutes les requêtes, y compris depuis n8n.
La documentation officielle de l’API Supabase détaille la différence entre ces clés et les règles de sécurité associées.
Comment ajouter ces identifiants dans n8n ?
Une fois l’URL et la clé en main, la configuration côté n8n prend moins de deux minutes.
- Ouvrir Credentials puis NewDans le menu de gauche de n8n, rechercher « Supabase API ».
- Renseigner Host et Service Role SecretColler l’URL du projet dans Host et la clé dans le champ dédié.
- Enregistrer et tester la connexionn8n confirme immédiatement si les identifiants sont valides.
- Nommer l’identifiant clairementUtile dès qu’un même compte gère plusieurs projets Supabase.
La documentation n8n sur les credentials rappelle que ces identifiants sont chiffrés et réutilisables dans tous les workflows de l’instance, sans les ressaisir à chaque node.
Comment utiliser le node Supabase dans un workflow ?
Une fois l’identifiant créé, le node Supabase se glisse dans n’importe quel workflow comme un node classique. Il propose quatre opérations principales sur les lignes d’une table.
| Opération | À quoi elle sert | Exemple d’usage |
|---|---|---|
| Create Row | Ajouter une nouvelle ligne dans une table. | Enregistrer un lead reçu par webhook. |
| Get Row(s) | Lire une ou plusieurs lignes selon un filtre. | Vérifier si un contact existe déjà avant de le recontacter. |
| Update Row | Modifier des champs d’une ligne existante. | Passer le statut d’un dossier de « en cours » à « traité ». |
| Delete Row | Supprimer une ligne selon un filtre. | Nettoyer les entrées de test après un déploiement. |
Le mapping des champs se fait visuellement : chaque colonne de la table Supabase apparaît comme un champ à remplir dans le node, à partir des données reçues plus tôt dans le workflow. La documentation du node Supabase détaille chaque option, y compris les filtres combinés et la pagination sur les lectures.
Pour transmettre des données à ce node depuis une source externe, notre article sur l’utilisation des webhooks dans n8n montre comment déclencher le workflow dès la réception d’un formulaire.
À quoi ressemble cette connexion sur le terrain ?
Voici un exemple représentatif de notre méthode, sans donnée client ni chiffre inventé.
Une table Supabase comme mémoire de nos workflows de prospection
Chez Amari Agency, un workflow n8n reçoit les nouveaux contacts par webhook, interroge Supabase avec une opération Get Row pour vérifier qu’ils n’ont pas déjà été traités, puis insère la nouvelle ligne avant de déclencher un envoi via Resend. Toute la séquence est journalisée dans Supabase, ce qui permet de revoir l’historique sans reconstruire le raisonnement à chaque fois.
Ce fonctionnement évite deux écueils fréquents : recontacter deux fois la même personne et perdre le contexte d’un dossier en cas de coupure du workflow.
Quelles erreurs éviter lors de la connexion ?
Elle ignore les règles RLS de la table. À réserver aux workflows internes exécutés sur une instance n8n sécurisée, jamais à un usage exposé publiquement.
Bonnes pratiques observées
- Nommer chaque identifiant Supabase par projet.
- Tester le node avec un enregistrement fictif avant la mise en production.
- Vérifier les types de colonnes (date, nombre, texte) avant le mapping.
- Activer les logs d’exécution n8n sur les workflows sensibles.
Erreurs fréquentes
- Table avec RLS activé sans politique définie : toutes les requêtes échouent.
- Confusion entre clé anon et clé service_role.
- Filtre de recherche mal typé sur une opération Get Row.
- Oublier de gérer le cas où aucune ligne ne correspond au filtre.
La documentation n8n sur la sécurité et la gestion des erreurs dans les workflows permettent d’anticiper la plupart de ces situations avant qu’elles n’affectent la production.
Quels cas d’usage concrets pour n8n et Supabase ?
Centraliser les leads
Regrouper dans une table unique les contacts venus d’un formulaire, d’un webhook ou de LinkedIn.
Journaliser les exécutions
Garder une trace de chaque étape d’un workflow pour faciliter le débogage et l’audit.
Donner une mémoire à un agent IA
Stocker le contexte d’une conversation pour qu’un agent créé dans n8n s’en souvienne d’un échange à l’autre.
Synchroniser avec WordPress ou un CRM
Faire de Supabase le point central entre plusieurs outils qui ne communiquent pas nativement entre eux.
Pour aller plus loin sur la création d’un agent capable d’exploiter cette mémoire, notre article comment créer un agent IA avec n8n sans être développeur détaille la logique d’un agent connecté à ses propres outils. Si vous préférez qu’une équipe cadre et développe ce type de connexion pour vous, notre page solutions d’automatisation IA sur mesure présente notre accompagnement.
Quels contenus lire ensuite ?
Ces ressources complètent ce tutoriel sans cibler la même requête :
Questions fréquentes sur n8n et Supabase
Faut-il écrire du SQL pour utiliser Supabase avec n8n ?
Non, pas pour les opérations courantes. Le node Supabase de n8n propose des champs visuels pour créer, lire, mettre à jour ou supprimer des lignes sans écrire de requête.
Quelle clé API Supabase utiliser dans n8n : anon ou service_role ?
La clé anon respecte les règles de sécurité RLS et convient à la majorité des workflows. La clé service_role les contourne : à réserver à des workflows internes sur une instance sécurisée.
Peut-on déclencher un workflow n8n depuis un changement dans Supabase ?
Oui, via les fonctions et webhooks de base de données de Supabase, qui peuvent appeler un webhook n8n dès qu’une ligne est créée ou modifiée.
Supabase est-il gratuit pour un usage avec n8n ?
Supabase propose un plan gratuit avec des limites de stockage et de requêtes, suffisant pour tester une connexion n8n. Un usage en production dépasse généralement ce plan.
Peut-on héberger n8n et Supabase sur le même serveur ?
Techniquement oui, en auto-hébergeant les deux, mais cela demande de gérer soi-même les sauvegardes et la sécurité de la base, ce que le plan cloud de Supabase prend en charge par défaut.