Ressources · Intégration n8n

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

Pourquoi automatiser

À 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.

Connexion

Comment connecter Contentful à n8n ?

  1. 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.

  2. 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.

  3. 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.

Actions

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.

Matrice ressources × opérations
RessourceGetGet Many
Asset✓✓
Content Type✓
Entry✓✓
Locale✓
Space✓

Asset

2 opérations
01

Get

asset.get

Ce 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 : deliveryApi lit le publié, previewApi lit l'état brouillon, et ce choix change ce que le nœud renvoie.
  • Environment ID : l'environnement interrogé, master ou staging par exemple ; sans environnements sur ton plan, reste sur master.
Cas d'usage
un envoi produit qui a besoin d'un visuel précis avant de passer la main à l'outil d'emailing.
02

Get Many

asset.getAll

Ce 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.createdAt pour 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.
Cas d'usage
le passage en revue trimestriel de tout ce qui a été uploadé depuis la dernière fois.

Content Type

1 opération
03

Get

contentType.get

Ce 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 : deliveryApi ou previewApi, selon l'API sur laquelle ton workflow est authentifié.
  • Environment ID : permet de contrôler le modèle sur staging avant que la même vérification tourne sur master.
Cas d'usage
une étape de garde qui lit le modèle d'abord, pour qu'un mapping plus loin ne dérive pas en silence après une modification de structure.

Entry

2 opérations
04

Get

entry.get

Ce 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 : previewApi pour inspecter une entrée encore en brouillon, deliveryApi pour la version en ligne.
  • RAW Data : conserve la réponse brute, pratique quand le nœud suivant attend la structure d'origine.
Cas d'usage
un circuit de relecture qui va chercher le brouillon d'un article et le soumet à validation avant publication.
05

Get Many

entry.getAll

Ce 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.createdAt pour partir des plus récentes.
Cas d'usage
l'export hebdomadaire des articles publiés vers la feuille que l'équipe éditoriale relit déjà.

Locale

1 opération
06

Get Many

locale.getAll

Ce 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 staging apparaît là avant master.
  • Return All : activé pour la liste complète ; désactivé, Limit décide du nombre de locales renvoyées.
  • Source : deliveryApi ou previewApi, en cohérence avec le token enregistré dans le credential.
Cas d'usage
le premier nœud d'un contrôle de traduction, qui alimente une boucle chargée de lire chaque version d'une entrée.

Space

1 opération
07

Get

space.get

Ce 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 : deliveryApi ou previewApi ; lancer l'opération une fois sur chacun montre tout de suite lequel des deux tokens a réellement été rempli.
Cas d'usage
un contrôle de santé en tête de workflow planifié, pour qu'un token cassé produise une erreur nette plutôt qu'un rapport vide plus loin.
Besoin d'aide

Besoin d'aide pour automatiser Contentful avec n8n ?

L'équipe te répond directement.

Chaque message est lu par une personne.

FAQ

Contentful et n8n, les questions fréquentes

01L'intégration Contentful n8n est-elle gratuite ?
Oui du côté n8n. Le nœud Contentful est livré avec n8n, il n'y a donc rien à installer et rien à payer en plus : le comportement est le même sur n8n Cloud, l'offre hébergée par n8n, et sur une instance auto-hébergée installée via Docker ou npm. Un workflow construit d'un côté tourne de l'autre sans modification. Ce que coûte Contentful selon ton plan est une autre question, que cette page ne traite pas. Côté Contentful, il te faut simplement un compte, un espace et un token d'accès à l'API pour démarrer.
02Quels identifiants faut-il pour connecter Contentful à n8n ?
Un seul credential Contentful, basé sur un token d'accès à l'API. Dans n8n, un credential est le jeu d'identifiants enregistré que tous tes workflows réutilisent : tu le saisis une fois dans le menu Credentials, puis tu le choisis dans la liste déroulante du nœud. Il demande trois valeurs : le Space ID, que Contentful affiche pendant la génération des tokens, un Content Delivery API Access Token si tu veux lire le contenu publié, et un Content Preview API Access Token si tu veux lire les brouillons. Un token que tu n'utilises pas peut rester vide. Les deux se génèrent ensemble depuis Settings > API keys.
03Quelles sont les limites du nœud Contentful dans n8n ?
Le nœud couvre 7 opérations réparties sur 5 ressources : Asset, Content Type, Entry, Locale et Space. Tout ce qui sort de cette liste passe par le nœud HTTP Request, qui appelle n'importe quel endpoint de l'API Contentful en réutilisant le même credential via l'authentification prédéfinie. Sur les opérations de liste, surveille Return All : laissé désactivé, le nœud s'arrête à Limit, et c'est comme ça qu'un export partiel finit par passer pour complet. Environment ID compte aussi, puisqu'une lecture sur staging et une lecture sur master peuvent légitimement renvoyer des contenus différents pour le même identifiant.
04Peut-on réagir en temps réel à une modification Contentful ?
Pas depuis le nœud Contentful lui-même, parce que cet outil n'a pas de nœud trigger dans n8n. Un workflow qui touche à Contentful démarre donc ailleurs. L'option la plus courante est le Schedule Trigger, qui lance le workflow à intervalle fixe, chaque matin ou chaque heure, avant d'aller lire l'espace avec Get Many Entries ou Get Many Assets. Deuxième option, le nœud Webhook de n8n, une URL qu'un autre service appelle quand quelque chose se passe chez lui, et qui enclenche ensuite la lecture. Troisième option, le trigger d'un outil déjà présent dans le workflow.
05n8n ou Make pour Contentful ?
Ça dépend de l'endroit où tu veux faire vivre l'automatisation. Make est une plateforme hébergée, sans option d'auto-hébergement, facturée à l'opération : le coût suit donc le nombre d'étapes que tes scénarios exécutent. n8n s'auto-héberge via Docker ou npm, ou s'utilise sur n8n Cloud, et le même workflow se comporte de façon identique dans les deux cas. Si tes données de contenu doivent rester sur une infrastructure que tu maîtrises, la question est réglée. Si tu ne veux jamais gérer de serveur, la version hébergée des deux outils fait le travail. Regarde le modèle de coût et la logique visuelle que tu lis le plus facilement, puis tranche.