Ressources · Intégration n8n

Intégration Storyblok n8nAutomatiser Storyblok avec n8n.

Récupérer une story sans ouvrir le CMS, c'est la promesse. L'intégration Storyblok n8n, c'est un nœud livré dans n8n avec 2 opérations sur une seule ressource, Story : lire une entrée, ou lister ce que contient un espace. Aucun trigger Storyblok n'existe, le workflow démarre donc ailleurs.

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

Pourquoi automatiser

L'intégration Storyblok n8n, concrètement ?

L'intégration Storyblok n8n, c'est un nœud livré dans n8n qui lit tes espaces Storyblok depuis un workflow, cette suite d'étapes automatiques que tu assembles à l'écran. Il gère une ressource, Story, avec 2 opérations : Get a story et Get many stories. Tu choisis l'espace, tu choisis via le champ Source si les données viennent de la Content API ou de la Management API, et chaque story arrive au nœud suivant sous forme d'item exploitable.

Le premier usage est bête comme chou et rend service tous les jours : l'inventaire de contenu que personne ne tient à jour. Un Schedule Trigger, le nœud qui lance un workflow à intervalle fixe, déclenche l'exécution, Get many stories rend l'espace entier, et la liste atterrit dans Google Sheets. Les rédacteurs voient ce qui existe sans se connecter, et l'export manuel disparaît du rituel.

Deuxième usage, plus chirurgical. Une étape de ton workflow connaît déjà un slug, la partie lisible de l'URL d'une story. Get a story prend cette valeur dans Identifier et renvoie l'entrée, de quoi pousser une notification complète dans Slack dès qu'un contenu est cité quelque part. Une story, un appel, zéro copier-coller.

Troisième usage, celui qui dure. Les équipes qui suivent leur production recopient la liste des stories dans une base qu'elles maîtrisent. Get many stories avec Return All activé enchaîne les pages de l'API jusqu'à ramener tout l'espace, et un nœud Airtable écrit les lignes. Le suivi éditorial se fait là, le CMS reste le CMS.

Le nœud couvre la ressource Story. Pour un endpoint que le nœud n'expose pas, le nœud HTTP Request appelle n'importe quel endpoint de l'API Storyblok en réutilisant exactement le même credential via l'authentification prédéfinie. L'intérêt est pratique : tu restes dans un seul workflow, avec un seul accès enregistré, au lieu d'entretenir un script à côté.

Deux points à connaître avant de construire. Le credential décide de ce que tu peux faire, puisqu'une clé Content API donne un accès en lecture seule là où une clé Management API couvre le CRUD complet. Et n8n ne prend en charge que la v1 de la Content API. Si tu veux d'abord juger la plateforme, l'Avis n8n creuse le sujet, et la Formation n8n t'apprend à monter ces workflows toi-même.

Connexion

Comment brancher Storyblok sur n8n ?

  1. 01

    Choisir la bonne clé

    Storyblok propose deux méthodes d'authentification, et le choix n'a rien d'anodin. Une clé Content API donne un accès en lecture seule, ce qui suffit aux deux opérations du nœud si tu te contentes de lire. Une clé Management API couvre le CRUD complet. Prends la plus étroite quand la lecture te suffit : une clé qui ne sait que lire ne fera pas de dégâts si elle traîne dans un workflow partagé.

  2. 02

    Générer le jeton dans Storyblok

    Pour une clé Content API, ouvre ton espace de travail Storyblok et va dans Settings > Access Tokens. Choisis un Access Level Public, qui correspond à version=published, ou Preview, qui couvre version=published et version=draft. Copie le jeton et renseigne-le dans le champ API Key. Pour une clé Management API, direction My Account > Personal access tokens : génère le jeton et colle-le dans Personal Access Token.

  3. 03

    Enregistrer l'accès dans n8n

    Dans n8n, va dans le menu Credentials et crée le credential Storyblok avec le jeton copié. Un credential, c'est un accès enregistré : tu le crées une fois, et tous tes workflows suivants te le proposent dans la liste déroulante du nœud. Pose ensuite un nœud Storyblok, sélectionne ce credential, et le champ Space Name or ID charge les espaces accessibles. Tu choisis dans la liste au lieu de retaper un identifiant de tête.

Actions

Ce que le nœud Storyblok sait faire

Le nœud Storyblok expose 2 opérations sur 1 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
RessourceGetGet Many
Story✓✓

Story

2 opérations
01

Get a story

story.get

Ce que tu vois dans n8n

Notes & cas d'usage

Sort une entrée précise d'un espace et la transmet au nœud suivant sous forme d'un item unique.

Paramètres clés

  • Space Name or ID : le nom de l'espace. Tu le prends dans la liste que n8n charge, ou tu passes un ID par une expression, cette syntaxe {{ }} qui va chercher une valeur au lieu de l'écrire en dur.
  • Identifier : l'ID ou le slug de la story à récupérer, souvent {{ $json.field }} quand la valeur vient d'un nœud précédent.
  • Story ID : l'identifiant numérique de la story.
  • Source : d'où viennent les données, Content API ou Management API.
Cas d'usage
un formulaire remonte un slug, le workflow le place dans Identifier, et l'entrée revient prête à être diffusée.
02

Get many stories

story.getAll

Ce que tu vois dans n8n

Notes & cas d'usage

Renvoie les stories d'un espace, un item n8n par story, prêtes à être bouclées ou recopiées ailleurs.

Paramètres clés

  • Space Name or ID : l'espace à lire, choisi dans la liste ou donné en ID via une expression.
  • Source : Content API ou Management API, à toi de dire d'où viennent les données.
  • Return All : activé, n8n enchaîne les pages de l'API jusqu'à la dernière story ; désactivé, Limit plafonne le nombre de résultats.
  • Starts With : dans Filters, restreint le résultat par slug.
Cas d'usage
l'inventaire d'un seul dossier du blog, resserré avec Starts With, exporté pour la revue éditoriale du trimestre.
Besoin d'aide

Besoin d'aide pour automatiser Storyblok avec n8n ?

L'équipe te répond directement.

Chaque message est lu par une personne.

FAQ

Storyblok et n8n : les questions d'après

01L'intégration Storyblok n8n est-elle gratuite ?
Côté n8n, oui. Le nœud Storyblok est livré avec n8n : rien à installer, aucun coût supplémentaire, que tu travailles sur n8n Cloud, l'offre hébergée par n8n, ou sur ta propre instance (Community Edition, licence Sustainable Use). Un même workflow se comporte pareil des deux côtés. Ce que coûte un abonnement Storyblok est une autre histoire, que cette page ne traite pas. La seule chose à mettre en place chez toi, c'est le credential, cet accès que n8n enregistre une fois et réutilise partout, et le créer ne coûte rien.
02Quels credentials ou droits faut-il pour le nœud Storyblok ?
Deux méthodes d'authentification existent, et celle que tu retiens fixe ce que le nœud peut atteindre. Une clé Content API donne un accès en lecture seule : génère-la dans ton espace de travail Storyblok via Settings > Access Tokens, avec un Access Level Public, soit version=published, ou Preview, qui couvre version=published et version=draft, puis renseigne-la dans API Key. Une clé Management API couvre le CRUD complet : génère un Personal Access Token depuis My Account > Personal access tokens et colle-le dans le champ du même nom. À savoir avant de commencer : n8n ne prend en charge que la v1 de la Content API.
03Quelles sont les limites du nœud Storyblok ?
Le nœud expose la ressource Story avec 2 opérations, donc la réponse dépend de ce que tu cherches à faire. Sur Get many stories, c'est Return All qui commande le volume : activé, n8n enchaîne les pages de l'API jusqu'à ramener la dernière story ; désactivé, Limit fixe le nombre maximal de résultats. Pour un endpoint que le nœud n'expose pas, le nœud HTTP Request appelle n'importe quel endpoint de l'API Storyblok en réutilisant le même credential via l'authentification prédéfinie. Et un champ marqué requis bloque l'exécution du nœud tant qu'il reste vide.
04Un événement Storyblok peut-il déclencher un workflow en temps réel ?
Il n'existe pas de nœud trigger Storyblok dans n8n, donc un workflow autour de Storyblok démarre forcément ailleurs. Trois points de départ couvrent presque tous les cas. Le Schedule Trigger part à intervalle fixe puis lance Get many stories, ce qui va très bien pour un inventaire ou un export. Le nœud Webhook de n8n te donne une URL, c'est-à-dire une adresse qu'un service tiers appelle quand quelque chose se passe chez lui. Ou le trigger d'un autre outil déjà présent dans tes workflows lance l'exécution, et le nœud Storyblok vient ensuite chercher le contenu associé.
05n8n ou Make pour Storyblok ?
Les deux se connectent à Storyblok, la décision se joue donc ailleurs. Make est une plateforme d'automatisation hébergée, sans option d'auto-hébergement, facturée à l'opération. n8n tourne sur n8n Cloud ou sur une instance que tu héberges toi-même via Docker ou npm, et le workflow reste identique dans les deux cas. Les critères sont donc : où tourne le workflow, quelle maîtrise tu veux sur le contenu qui y transite, comment le coût évolue avec le volume, et quelle logique visuelle ton équipe lit le plus vite. Sur de gros espaces, ce sont souvent les deux derniers qui tranchent.