- Accueil
- Ressources
- Intégrations
- Storyblok
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
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.
Comment brancher Storyblok sur n8n ?
- 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é.
- 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 couvreversion=publishedetversion=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. - 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.
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.
Sommaire des opérations
Story
2 opérationsGet a story
story.getCe 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.
Get many stories
story.getAllCe 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.
Besoin d'aide pour automatiser Storyblok avec n8n ?
L'équipe te répond directement.
Chaque message est lu par une personne.