Ressources · Intégration n8n

Intégration GraphQL n8nAutomatiser GraphQL avec n8n.

Une seule URL, à condition de savoir la questionner. L'intégration GraphQL n8n tient dans 1 opération et 4 champs requis : tu écris la requête, n8n range la réponse dans la propriété que tu nommes. Aucun trigger livré : un horaire démarre l'exécution. Pour qui lit déjà son schéma.

Tester l'intégration GraphQL sur n8nVoir les 1 opérations

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

Pourquoi automatiser

Que fait vraiment l'intégration GraphQL n8n ?

Avec une API REST, chaque information a son URL. Avec GraphQL, il n'y en a qu'une, et c'est la requête qui décide du contenu de la réponse. Le nœud n8n joue le rôle du client qui envoie cette requête : tu remplis l'URL, le texte de la requête et le nom de la propriété où ranger le résultat. Les nœuds suivants travaillent sur cette propriété. Une opération, une ressource, pas de menu à explorer.

Premier cas, le chargement en masse. Les lignes partent de Google Sheets, le nœud envoie une mutation par ligne vers Shopify pour créer le produit et poser son stock, et la feuille reste l'endroit où le catalogue se modifie. Chaque réponse revient dans le workflow sous la propriété que tu as nommée, donc l'exécution garde la trace de ce que l'API a répondu.

Deuxième cas, le rapport du matin. Une seule requête récupère les chiffres de la veille en un aller-retour, la réponse atterrit dans la propriété nommée, et les lignes continuent vers Postgres ou Supabase. L'intérêt de GraphQL tient ici en une phrase : la requête choisit les champs, le workflow ne transporte rien qu'il ne lira jamais.

Troisième cas, la veille. Un Schedule Trigger, le déclencheur qui part à intervalle fixe, tourne toutes les heures, le nœud demande à Product Hunt le top 5 des produits du moment, et la liste tombe dans un message Discord. Personne n'ouvre de tableau de bord, le salon fait le travail.

Le nœud ne couvre qu'une opération, c'est la forme normale d'un client générique. Pour un endpoint REST du même service, ou pour un appel que ce nœud ne sait pas formuler, le nœud HTTP Request atteint n'importe quelle URL et réutilise le credential, l'identifiant de connexion enregistré une fois dans n8n et repris dans tous les workflows, grâce à son authentification prédéfinie.

Deux limites méritent d'être connues avant de construire. Il n'existe pas de trigger GraphQL, ce nœud qui démarre un workflow tout seul : l'exécution part d'un Schedule Trigger à intervalle fixe, d'un Webhook n8n (une URL qu'un service extérieur appelle) ou du trigger d'un autre outil. Et le nœud n'a ni Return All ni Limit : le nombre d'éléments renvoyés dépend de la requête envoyée. Pour prendre du recul, l'Avis n8n parle de la plateforme elle-même, et la Formation n8n reprend la construction d'un workflow depuis le premier nœud.

Connexion

Comment connecter GraphQL à n8n ?

  1. 01

    Choisir le mode d'authentification

    GraphQL est un langage de requête, pas un service unique : le nœud laisse donc l'authentification ouverte. None convient à un endpoint public. Header Auth ou Query Auth répondent à une API qui attend un jeton dans un en-tête ou dans l'URL. Basic Auth et Digest Auth prennent un identifiant et un mot de passe. OAuth1 et OAuth2 servent aux accès délégués à un compte, et Custom Auth aux API qui mélangent plusieurs de ces mécanismes.

  2. 02

    Enregistrer le credential une seule fois

    Un credential, c'est le bloc d'identifiants que n8n conserve pour toi. Tu le crées dans le menu Credentials, tu lui donnes un nom que tu reconnaîtras dans six mois, et tous les workflows de l'instance peuvent s'en servir. Le nœud GraphQL le propose ensuite dans sa liste déroulante. Changer un jeton plus tard, c'est modifier ce credential, pas chaque nœud qui appelle l'API.

  3. 03

    Pointer le nœud sur l'endpoint

    Colle l'URL de l'API dans Endpoint, sur le modèle http://example.com/graphql. Règle HTTP Request Method sur GET ou POST selon ce que l'API accepte, écris une requête courte dans Query et lance le nœud une fois. Une réponse lisible sous la propriété indiquée dans Response Data Property Name prouve que la connexion tient.

Actions

Ce que le nœud GraphQL sait faire

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

01

Makes a GraphQL request and returns the received data

execute

Ce que tu vois dans n8n

Notes & cas d'usage

Le nœud envoie une requête à l'endpoint configuré et transmet la réponse au nœud suivant, rangée sous le nom de propriété choisi.

Paramètres clés

  • Endpoint : l'URL qui accepte les requêtes, sur le modèle http://example.com/graphql.
  • Request Format : graphql envoie la requête en texte brut, json l'emballe dans un corps JSON.
  • Query : la requête elle-même, où l'expression {{ $json.id }} va chercher une valeur dans l'item entrant.
  • Response Data Property Name : la propriété qui reçoit la réponse, et le nom que liront les nœuds suivants.
Cas d'usage
récupérer en un appel les seuls champs dont un rapport hebdomadaire a besoin, au lieu d'enchaîner plusieurs requêtes.
Besoin d'aide

Besoin d'aide pour automatiser GraphQL avec n8n ?

L'équipe te répond directement.

Chaque message est lu par une personne.

FAQ

GraphQL et n8n : les questions fréquentes

01L'intégration GraphQL n8n est-elle gratuite ?
Oui. Le nœud GraphQL est livré avec n8n : rien à installer, rien à payer en plus côté n8n, sur n8n Cloud comme sur une instance auto-hébergée en Community Edition, sous licence Sustainable Use. Le workflow se comporte de la même façon des deux côtés, donc tu peux le préparer sur l'un et le déplacer sur l'autre sans retoucher la requête. Le credential se crée gratuitement et sert à tous les workflows de l'instance. Ce que facture l'API interrogée, en revanche, ne dépend pas de n8n et se règle avec celui qui l'exploite.
02Quels credentials faut-il pour le nœud GraphQL ?
Ça dépend de l'API visée, et le nœud couvre 8 possibilités : None, Basic Auth, Digest Auth, Header Auth, Query Auth, OAuth1, OAuth2 et Custom Auth. Un endpoint public qui ne demande aucune identification tourne avec None. Une API qui attend un jeton dans un en-tête utilise Header Auth, et celle qui l'attend dans l'URL utilise Query Auth. Basic Auth et Digest Auth prennent un identifiant et un mot de passe. OAuth1 et OAuth2 valent pour un accès délégué à un compte. Custom Auth couvre les endpoints qui combinent plusieurs de ces mécanismes. Le credential se crée une fois dans le menu Credentials, puis se choisit dans le nœud.
03Quelles sont les limites du nœud GraphQL dans n8n ?
Le nœud fait une chose : il envoie une requête et renvoie les données reçues. Ni Return All ni Limit ici, donc le nombre d'éléments qui reviennent dépend de la requête, et parcourir une longue liste page après page se joue dans cette requête. Toute la réponse atterrit sous une seule propriété, celle nommée dans Response Data Property Name, et les nœuds suivants lisent à cet endroit. Il n'y a pas non plus de trigger GraphQL. Quand un endpoint sort de ce que ce nœud sait exprimer, le nœud HTTP Request appelle n'importe quelle URL de la même API et réutilise le credential déjà enregistré.
04Le nœud GraphQL réagit-il en temps réel ?
Non, puisque n8n n'a pas de nœud trigger GraphQL. Rien du côté de l'endpoint ne réveille un workflow tout seul, c'est donc toi qui choisis le départ. Un Schedule Trigger relance la requête à intervalle fixe, toutes les heures pour une veille, une fois par jour pour un rapport. Un Webhook n8n donne au workflow sa propre URL, et n'importe quel service capable d'appeler cette URL lance l'exécution. Le trigger d'un autre outil marche aussi bien : une nouvelle ligne, un nouveau message, un nouveau fichier, et la requête GraphQL suit dans la même exécution.
05n8n ou Make pour GraphQL ?
Ça dépend de l'endroit où le workflow doit vivre. n8n tourne sur n8n Cloud ou sur ton propre serveur via Docker ou npm, et une instance auto-hébergée garde la requête et la réponse dans ton réseau, ce qui compte quand l'endpoint est interne. Make est hébergé par Make, sans option d'auto-hébergement, et facture à l'opération : une requête toutes les heures devient un coût à l'opération d'un côté, une facture de serveur de l'autre. Les deux dessinent le workflow visuellement. Les vrais critères sont l'hébergement, la maîtrise des données, le modèle de coût et le canvas que ton équipe lit le plus vite.
Hack'celeration Lab

Reçois nos tips intégration chaque semaine.

Pas de spam. Désinscription à tout moment.

Même plateforme

Autres docs utiles sur ce stack.

Voir toutes les intégrations