- Accueil
- Ressources
- Intégrations
- Contentful
Intégration Contentful n8nAutomatiser Contentful avec n8n.
Ton contenu n'a aucune raison de rester coincé dans l'interface Contentful. L'intégration Contentful n8n donne à un workflow de quoi lire un espace : 7 opérations réparties sur 5 ressources, des assets aux locales. Pour les équipes contenu et ops qui publient à un rythme régulier.
Avis vérifiés sur Trustpilot · Agence IA, automatisation & growth
À quoi sert l'intégration Contentful n8n ?
Le nœud Contentful rend un espace lisible depuis un workflow, c'est-à-dire une suite d'étapes automatisées que n8n exécute pour toi. Il est livré avec n8n, donc rien à installer, ni sur n8n Cloud ni sur une instance auto-hébergée, et il s'authentifie avec un token d'accès à l'API Contentful enregistré une seule fois. Le catalogue compte 7 opérations sur 5 ressources : Asset, Content Type, Entry, Locale et Space.
Commence par la médiathèque, c'est le cas le plus visible. Get Many Assets avec Return All activé parcourt tous les fichiers de l'espace page après page, et le récapitulatif part dans Slack, sur le canal des designers. Les équipes qui publient beaucoup de visuels s'en servent pour garder un œil sur ce qui s'accumule.
Deuxième usage, la vérification des traductions. Get Many Locales renvoie les locales configurées sur l'espace, donc la liste réelle des langues et pas celle que tout le monde croit. Une boucle sur Get an Entry récupère ensuite chaque version, et quand il en manque une, la relance part par SendGrid au responsable de la langue concernée.
Troisième usage, l'inventaire éditorial. Get Many Entries filtré sur un Content Type ID ramène toutes les entrées d'un même modèle, et les lignes atterrissent dans Google Sheets. L'équipe trie par date, repère les pages que plus personne ne touche, et la feuille se réécrit toute seule au passage suivant du workflow.
Un point à trancher tôt : Contentful n'a pas de nœud trigger dans n8n. Le workflow démarre donc ailleurs, avec un Schedule Trigger qui se déclenche à intervalle fixe, avec un Webhook n8n, c'est-à-dire une URL qu'un autre service appelle, ou avec le trigger d'un outil déjà présent dans ta chaîne. Ce choix décide de la fraîcheur des données que tu affiches.
Tout ce qui sort de ces 7 opérations du catalogue passe par le nœud HTTP Request, qui appelle n'importe quel endpoint de l'API Contentful en réutilisant le même credential. Le template public 640, Get all the entries from Contentful, montre le nœud branché sur un cas simple. Si tu veux monter en autonomie sur l'outil, la Formation n8n couvre ce genre de montage.
Comment connecter Contentful à n8n ?
- 01
Générer les clés dans Contentful
Il te faut un compte Contentful et un espace avant de toucher à n8n. Ouvre Settings > API keys et crée une clé : le Space ID s'affiche pendant la génération des tokens, et la même clé produit à la fois un Content Delivery API Access Token et un Content Preview API Access Token. Laisse l'onglet ouvert, ces trois valeurs vont directement dans n8n.
- 02
Enregistrer le credential une fois pour toutes
Dans n8n, un credential est un jeu d'identifiants enregistré que tous les workflows réutilisent. Passe par le menu Credentials, crée un credential Contentful et remplis le Space ID, le Content Delivery API Access Token et le Content Preview API Access Token. Un token que tu ne comptes pas utiliser peut rester vide. Une fois sauvegardé, le nœud Contentful te le propose dans sa liste déroulante.
- 03
Tester avec une lecture minimale
Pose un nœud Contentful sur le canvas, choisis le credential, puis l'opération Get a Space. C'est l'aller-retour le plus court : aucun identifiant à fournir, juste Source. Si l'espace revient, le token est bon. Enchaîne ensuite sur une vraie opération et renseigne Environment ID, l'environnement Contentful que le nœud interroge, du type master ou staging.
Ce que le nœud Contentful sait faire
Le nœud Contentful expose 7 opérations sur 5 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
Asset
2 opérationsGet
asset.getCe que tu vois dans n8n
Notes & cas d'usage
Récupère un seul fichier déjà déposé dans l'espace. Tu le désignes à la main, ou par une expression n8n, qui va chercher la valeur dans l'item entrant. Pas besoin de balayer toute la médiathèque pour ça.
Paramètres clés
- Asset ID : l'identifiant du fichier dans Contentful, souvent via une expression comme
{{ $json.field }}quand un nœud précédent l'a transporté. - Source :
deliveryApilit le publié,previewApilit l'état brouillon, et ce choix change ce que le nœud renvoie. - Environment ID : l'environnement interrogé,
masteroustagingpar exemple ; sans environnements sur ton plan, reste surmaster.
Get Many
asset.getAllCe que tu vois dans n8n
Notes & cas d'usage
Renvoie les fichiers de l'espace sous forme de liste, avec des filtres de recherche. C'est l'opération qui permet d'auditer une médiathèque en une exécution.
Paramètres clés
- Return All : activé, n8n enchaîne les pages jusqu'au dernier fichier ; désactivé, Limit fixe le nombre de fichiers ramenés.
- Order : trie la réponse sur une propriété sys ou une valeur de champ, par exemple
sys.createdAtpour voir les derniers ajouts en tête. - Fields : la liste des champs à renvoyer, séparés par des virgules, quand seul le titre sert à l'étape suivante.
- RAW Data : renvoie la réponse non parsée, pour les workflows qui préfèrent traiter la structure eux-mêmes.
Content Type
1 opérationGet
contentType.getCe que tu vois dans n8n
Notes & cas d'usage
Donne la définition d'un modèle de contenu, la structure que suivent toutes les entrées de ce type dans l'espace.
Paramètres clés
- Content Type ID : l'identifiant du modèle à lire, repris de Contentful ou passé via une expression comme
{{ $json.field }}. - Source :
deliveryApioupreviewApi, selon l'API sur laquelle ton workflow est authentifié. - Environment ID : permet de contrôler le modèle sur
stagingavant que la même vérification tourne surmaster.
Entry
2 opérationsGet
entry.getCe que tu vois dans n8n
Notes & cas d'usage
Ramène un contenu unique à partir de son identifiant. C'est l'opération à utiliser une fois qu'une étape précédente a déjà désigné l'entrée qui compte.
Paramètres clés
- Entry ID : l'identifiant de l'entrée, en général via une expression comme
{{ $json.field }}quand il vient d'un formulaire ou d'une lecture antérieure. - Source :
previewApipour inspecter une entrée encore en brouillon,deliveryApipour la version en ligne. - RAW Data : conserve la réponse brute, pratique quand le nœud suivant attend la structure d'origine.
Get Many
entry.getAllCe que tu vois dans n8n
Notes & cas d'usage
Interroge les entrées de l'espace et les renvoie en liste. C'est l'opération de fond de la plupart des workflows Contentful.
Paramètres clés
- Content Type ID : restreint la recherche aux entrées d'un seul modèle, pour qu'un export d'articles ne ramène pas aussi les pages d'atterrissage.
- Query : recherche plein texte sur les entrées, insensible à la casse, et il lui faut plus d'un caractère pour fonctionner.
- Return All : activé, toutes les entrées correspondantes reviennent, sur autant de pages que nécessaire ; désactivé, Limit pose le plafond.
- Order : impose l'ordre de la réponse, par exemple
sys.createdAtpour partir des plus récentes.
Locale
1 opérationGet Many
locale.getAllCe que tu vois dans n8n
Notes & cas d'usage
Liste les locales configurées sur l'espace. Le workflow sait ainsi quelles langues il doit traiter, au lieu de les deviner.
Paramètres clés
- Environment ID : les locales se lisent par environnement, donc une langue ajoutée sur
stagingapparaît là avantmaster. - Return All : activé pour la liste complète ; désactivé, Limit décide du nombre de locales renvoyées.
- Source :
deliveryApioupreviewApi, en cohérence avec le token enregistré dans le credential.
Space
1 opérationGet
space.getCe que tu vois dans n8n
Notes & cas d'usage
Renvoie l'espace visé par le credential. Aucun identifiant à saisir, ce qui en fait le moyen le plus rapide de prouver que la connexion tient avant de construire quoi que ce soit dessus.
Paramètres clés
- Source :
deliveryApioupreviewApi; lancer l'opération une fois sur chacun montre tout de suite lequel des deux tokens a réellement été rempli.
Besoin d'aide pour automatiser Contentful avec n8n ?
L'équipe te répond directement.
Chaque message est lu par une personne.


