Ressources · Intégration n8n

Intégration Grist n8nAutomatiser Grist avec n8n.

L'intégration Grist n8n transforme une table Grist en base de données que tes workflows alimentent. Le nœud est livré avec n8n et expose 4 opérations sur une seule ressource : créer, lire, mettre à jour et supprimer des lignes. Pas de trigger Grist, le départ vient d'ailleurs.

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

Pourquoi automatiser

Que couvre vraiment l'intégration Grist n8n ?

L'intégration Grist n8n, c'est le nœud Grist livré avec n8n plus un credential Grist, c'est-à-dire un jeu d'identifiants enregistré une fois dans n8n. Dès que ce credential contient une clé API et une URL Grist, n'importe quel workflow lit les lignes d'une table, en ajoute, les modifie ou les efface, en pointant le document et la table par leur identifiant. Grist reste l'endroit où l'équipe travaille, n8n déplace.

Premier cas, des fiches d'intervention. Un technicien remplit un formulaire, un nœud Webhook, c'est-à-dire une URL de n8n appelée par le formulaire, récupère la réponse, et Create rows in a table écrit la ligne dans la table du jour avec Auto-Map Input Data to Columns. Grist renvoie l'identifiant de la ligne créée, que la suite du workflow réutilise.

Deuxième cas, la facturation du mois. Un Schedule Trigger, le nœud qui déclenche à intervalle fixe, lance Read rows from a table avec Return All activé pour ne perdre aucune page de résultats, puis les lignes partent vers Postgres pour la compta et un récapitulatif part par Gmail. La saisie, elle, ne bouge pas de Grist.

Troisième cas, les retards. Une lecture filtrée sort les lignes qui traînent, Update rows in a table passe chacune en relancé, et un message tombe dans Slack. Une équipe qui vient d'Airtable retrouve la même mécanique, avec un identifiant de document et de table à la place d'une base et d'un nom de table.

Le nœud s'arrête aux lignes. Créer, lire, mettre à jour, supprimer : la liste des 4 opérations de son unique ressource tient en une phrase. Tout le reste de l'API Grist passe par le nœud HTTP Request, qui réutilise le même credential via l'authentification prédéfinie, donc pas de deuxième clé à gérer. Le reste du positionnement de l'outil est traité dans l'Avis n8n.

Deux limites à connaître avant de construire. Il n'existe pas de trigger Grist, donc un workflow démarre toujours ailleurs, en général sur un Schedule Trigger ou sur un Webhook n8n appelé par un service tiers. Et modifier ou supprimer une ligne demande son Row ID, qu'on récupère soit dans la sortie de Read rows from a table, soit via une colonne ajoutée dans Grist avec la formule $id.

Connexion

Comment connecter Grist à n8n ?

  1. 01

    Créer la clé API dans Grist

    Dans Grist, ouvre le menu du compte via l'icône de profil en haut à droite, va dans Account settings puis Developer, et crée ou copie la clé API. Cette clé constitue toute l'authentification du nœud : le credential Grist n'accepte que la méthode API key, il n'y a donc aucun écran d'autorisation à valider ni application à approuver. Range-la comme un mot de passe.

  2. 02

    Indiquer la bonne URL Grist

    Le credential réclame une Grist URL en plus de la clé. Garde la valeur par défaut https://api.getgrist.com pour un compte hébergé sur getgrist.com. Passe à https://YOUR_TEAM.getgrist.com pour limiter la connexion à une seule équipe. Pour un serveur Grist auto-géré, mets son adresse, écrite sans /api et sans barre oblique finale.

  3. 03

    Enregistrer le credential et le choisir dans le nœud

    De retour dans n8n, ouvre le menu Credentials, crée un credential Grist, colle la clé et l'URL, enregistre. Ajoute ensuite un nœud Grist dans un workflow et sélectionne ce credential dans sa liste déroulante. Un credential se crée une fois et se réutilise dans tous les workflows de l'instance : l'étape ne se refait pas, que tu sois sur n8n Cloud ou en auto-hébergement.

Actions

Ce que le nœud Grist sait faire

Le nœud Grist expose 4 opérations. Pour chacune : le nœud tel que tu le configures dans n8n, les champs obligatoires, et nos notes de terrain.

01

Create rows in a table

create

Ce que tu vois dans n8n

Notes & cas d'usage

Cette opération ajoute une ou plusieurs lignes dans une table Grist et renvoie chacune avec le Row ID que Grist lui attribue.

Paramètres clés

  • Document ID : l'adresse du document, à copier dans Document Settings après un clic sur l'icône de profil.
  • Table ID : la table visée ; la Code View donne le vrai identifiant quand il diffère du nom affiché.
  • Data to Send : Auto-Map Input Data to Columns si les propriétés entrantes portent déjà le nom des colonnes, Define Below for Each Column sinon.
Cas d'usage
un formulaire d'inscription crée la fiche du contact, et le Row ID renvoyé sert au nœud suivant.
02

Delete rows from a table

delete

Ce que tu vois dans n8n

Notes & cas d'usage

La suppression est définitive côté Grist. Le contenu de la ligne n'est pas renvoyé, donc le workflow garde ce dont il a besoin avant d'appeler ce nœud.

Paramètres clés

  • Row ID : la ligne à retirer, ou plusieurs identifiants séparés par des virgules, souvent {{ $json.id }} issu d'une lecture.
  • Document ID et Table ID : requis tous les deux, parce qu'un identifiant de ligne n'a de sens que dans une table d'un document précis.
Cas d'usage
un nettoyage lit les doublons signalés, puis les efface en une passe.
03

Read rows from a table

getAll

Ce que tu vois dans n8n

Notes & cas d'usage

Lecture seule : le nœud ressort les lignes de la table, chacune avec son Row ID à côté des valeurs de colonnes.

Paramètres clés

  • Return All : activé, n8n enchaîne toutes les pages de résultats ; désactivé, Limit plafonne le nombre de lignes renvoyées.
  • Filter : à ajouter via Add Option, une entrée par colonne, plusieurs valeurs séparées par des virgules ; une ligne doit satisfaire toutes les colonnes listées.
  • Sort Order : ordonne les lignes avant leur sortie du nœud.
Cas d'usage
un export matinal lit toutes les lignes du suivi de commandes.
04

Update rows in a table

update

Ce que tu vois dans n8n

Notes & cas d'usage

Une ligne déjà présente reçoit de nouvelles valeurs. Toute la difficulté tient à désigner la bonne.

Paramètres clés

  • Row ID : la ligne unique à modifier ; une colonne Grist portant la formule $id la rend disponible comme n'importe quel champ.
  • Fields to Send : les colonnes à écrire, une par une, quand Define Below for Each Column est choisi.
  • Inputs to Ignore : les propriétés à laisser de côté, séparées par des virgules, quand l'auto-mapping en envoie trop.
Cas d'usage
un statut de livraison arrive et la commande correspondante passe en expédiée.
Besoin d'aide

Besoin d'aide pour automatiser Grist avec n8n ?

L'équipe te répond directement.

Chaque message est lu par une personne.

FAQ

Grist et n8n, les questions qui suivent

01L'intégration Grist n8n est-elle gratuite ?
Côté n8n, oui. Le nœud Grist est livré avec n8n : rien à installer, aucun coût supplémentaire, aussi bien sur n8n Cloud que sur une instance auto-hébergée en Community Edition sous licence Sustainable Use. Le credential se crée une fois dans le menu Credentials et se réutilise dans tous les workflows qui touchent à Grist, donc la mise en place coûte du temps, pas de l'argent. Ce que coûte un compte Grist ne se traite pas ici, ça dépend du plan souscrit chez Grist. Monte le workflow d'abord, confronte ensuite ce plan au volume que tu comptes déplacer.
02Quels credentials demande le nœud Grist ?
Une clé API et une URL Grist, rien de plus. La clé se récupère dans le menu du compte Grist, sous Account settings puis Developer, où on la crée ou la copie. L'URL indique à n8n quel serveur appeler : la valeur par défaut, api.getgrist.com, convient à tout compte hébergé sur getgrist.com, une adresse d'équipe restreint la connexion à cette seule équipe, et une installation auto-gérée utilise sa propre adresse, écrite sans le suffixe api et sans barre oblique finale. API key est la seule méthode d'authentification acceptée par le credential. Une fois enregistré, le nœud le propose dans sa liste.
03Quelles sont les limites du nœud Grist dans n8n ?
Il gère des lignes, et rien d'autre. Les 4 opérations créent, lisent, modifient et suppriment des lignes dans une table à la fois, adressée par identifiant de document et de table. Le reste de l'API Grist passe par le nœud HTTP Request, qui réutilise le même credential : rien n'est hors de portée, c'est juste un nœud plus loin. Deux contraintes pratiques en découlent. Modifier ou supprimer réclame le Row ID, fourni par la sortie de la lecture ou par une colonne Grist bâtie sur la formule id. Et le filtrage n'existe qu'en lecture, donc une condition complexe se prépare en colonne formule qui renvoie vrai.
04Existe-t-il un trigger Grist dans n8n ?
Non. Grist n'a pas de nœud trigger, donc aucun workflow ne démarre sur une modification faite dans un document Grist. Deux montages comblent le trou. Le Schedule Trigger tourne à intervalle fixe, lit la table et compare ce qu'il trouve à ce qui a déjà été traité : c'est du polling, n8n interroge Grist à chaque passage au lieu d'être prévenu. Ou bien un Webhook n8n, une URL appelée par un autre service, lance l'exécution et le nœud Grist écrit le résultat. Le premier convient aux synchronisations régulières, le second aux événements venus d'un formulaire ou d'un outil capable d'appeler une URL.
05n8n ou Make pour Grist ?
Tout dépend de l'endroit où les données doivent rester. n8n s'auto-héberge en Docker ou en npm, ou s'utilise sur n8n Cloud, et un workflow se comporte pareil dans les deux cas : le document Grist et son automatisation peuvent donc vivre sur une infrastructure que tu maîtrises. Make est hébergé uniquement, sans option d'auto-hébergement, et se facture à l'opération, ce qui reste lisible sur de petits volumes et l'est moins quand une synchronisation nocturne parcourt toutes les lignes d'une grosse table. Les deux proposent un éditeur visuel. Les vrais critères sont donc l'hébergement, la maîtrise des données, le modèle de coût et l'éditeur dans lequel ton équipe va plus vite.