Ressources · Intégration n8n

Intégration Mautic n8nAutomatiser Mautic avec n8n.

Tes contacts Mautic peuvent bouger tout seuls. L'intégration Mautic n8n repose sur deux nœuds : le nœud Mautic et ses 20 opérations réparties sur 6 ressources, et le Mautic Trigger, qui reçoit par webhook les événements de ton instance.

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

Pourquoi automatiser

Que couvre vraiment l'intégration Mautic n8n ?

Mautic est un logiciel open source d'automatisation marketing : génération de contacts, scoring, segmentation et campagnes, sur une instance que tu héberges. L'intégration Mautic n8n branche cette instance sur le reste de tes outils avec deux nœuds. Le nœud Mautic expose 20 opérations réparties sur 6 ressources, des contacts aux entreprises jusqu'aux segments, aux campagnes et aux emails. Le Mautic Trigger, lui, écoute l'instance par webhook, une URL que Mautic appelle quand un événement se produit.

Premier scénario, les inscriptions qui atterrissent dans le bon segment. Un formulaire posé sur un site Wordpress envoie sa réponse à n8n, contact.create écrit la personne dans Mautic avec son email et son prénom, puis contactSegment.add la classe dans le segment qui correspond au formulaire. Plus personne n'exporte de CSV le vendredi soir.

Deuxième scénario, le scoring qui suit ce que font vraiment les gens. Un événement produit arrive dans le workflow, contact.editContactPoint ajoute ou retire des points au contact, et campaignContact.add envoie dans une campagne ceux qui passent le seuil. La même exécution peut consigner le mouvement dans Google Sheets pour l'équipe commerciale.

Troisième scénario, les emails qui partent de Mautic mais se décident ailleurs. contact.sendEmail envoie à un contact précis un email de campagne déjà construit dans Mautic, segmentEmail.send envoie le même message à tout un segment. Les équipes qui arrivent d'Activecampaign gardent souvent ce partage : le design reste dans l'outil marketing, le déclenchement passe dans le workflow.

Le nœud couvre 6 ressources. Tout le reste de l'API Mautic passe par le nœud HTTP Request, qui appelle n'importe quel endpoint en réutilisant le même credential, l'identifiant enregistré une fois dans n8n, via son authentification prédéfinie. C'est la porte de sortie quand une opération manque au nœud dédié, et elle n'oblige à rien reconfigurer.

Deux limites à connaître avant de construire. Plusieurs opérations n'affichent pas leur identifiant comme obligatoire, Company ID ou Contact ID par exemple, alors que l'appel ne vise rien sans lui : traite-les comme requis. Et le trigger n'a pas de joker, les événements écoutés se cochent un par un dans Event Names or IDs, ou s'indiquent par leur identifiant avec une expression. L'Avis n8n détaille ce que la plateforme sait faire, et la Formation n8n reprend la construction de ces workflows pas à pas.

Connexion

Comment connecter Mautic à n8n ?

  1. 01

    Activer l'API dans Mautic

    Rien ne fonctionne tant que l'API reste fermée. Dans Mautic, ouvre Settings > Configuration, puis API Settings, passe API enabled? sur Yes et enregistre. Ce réglage commande les deux méthodes d'authentification et fait apparaître le menu API Credentials dont OAuth2 a besoin.

  2. 02

    Choisir entre basic auth et OAuth2

    La voie courte, c'est la basic auth : le credential demande l'URL de ton instance, un Username et un Password, et Mautic veut Enable HTTP basic auth? sur Yes dans Configuration > API Settings. OAuth2 réclame plutôt un Client ID, un Client Secret et la même URL de base.

  3. 03

    Créer le client et enregistrer le credential

    Pour OAuth2, va dans Configuration > Settings, ouvre API Credentials, choisis Create new client, sélectionne OAuth 2 comme Authorization Protocol et nomme-le n8n integration. Copie l'OAuth Callback URL de n8n dans le champ Redirect URI, applique, puis recopie le Client ID et le Client Secret côté n8n.

Déclencheurs

Qu'est-ce qui déclenche un workflow depuis Mautic ?

Mautic Trigger est le nœud qui démarre un workflow quand Mautic appelle n8n. Tu actives le workflow : n8n te donne l'URL du webhook à enregistrer dans Mautic, et chaque appel devient une exécution.

Ce que tu vois dans n8n

Notes de configuration

01Configure the Mautic TriggerLe Mautic Trigger enregistre un webhook, c'est-à-dire une URL que Mautic appelle de lui-même dès qu'un événement choisi se produit. L'enregistrement se fait à l'activation du workflow, et chaque événement arrive en quelques secondes : rien n'interroge l'instance à intervalle régulier.

Le Mautic Trigger enregistre un webhook, c'est-à-dire une URL que Mautic appelle de lui-même dès qu'un événement choisi se produit. L'enregistrement se fait à l'activation du workflow, et chaque événement arrive en quelques secondes : rien n'interroge l'instance à intervalle régulier.

Paramètres clés

  • Event Names or IDs : requis, et seul réglage vraiment indispensable. Coche les événements dans la liste, ou passe leurs identifiants avec une expression, la formule {{ $json.champ }} qui va chercher une valeur dans l'item entrant.
  • Events Order : DESC ou ASC, le sens de lecture quand Mautic met plusieurs événements en file et les livre dans un seul appel.
Quand l'utiliser
dès que la réaction doit suivre ce qui se passe dans Mautic, et pas une horloge. Le credential est celui du nœud Mautic, basic auth ou OAuth2, il n'y a donc rien de neuf à créer.
02Follow Up With the Mautic NodeUn trigger seul annonce qu'il s'est passé quelque chose, rien de plus. L'intérêt commence juste après, quand le nœud Mautic reprend la main : contact.get relit la fiche complète, contact.editContactPoint fait bouger le score, contactSegment.add range le contact ailleurs. Chacune de ces opérations récupère son Contact ID dans l'item produit par le trigger, via une expression, sans une seule saisie manuelle.

Un trigger seul annonce qu'il s'est passé quelque chose, rien de plus. L'intérêt commence juste après, quand le nœud Mautic reprend la main : contact.get relit la fiche complète, contact.editContactPoint fait bouger le score, contactSegment.add range le contact ailleurs. Chacune de ces opérations récupère son Contact ID dans l'item produit par le trigger, via une expression, sans une seule saisie manuelle.

Quand l'utiliser
quand la réaction a besoin d'une donnée que l'événement ne transporte pas, ou d'une écriture en retour dans Mautic. Un workflow qui lit, décide, puis écrit se débogue plus facilement que trois demi-automatisations éparpillées dans trois outils.
Cas d'usage
recevoir l'événement, relire le contact, puis l'orienter vers la campagne qui colle à son stade, sans qu'une personne ait à trier la liste.
Actions

Que sait faire le nœud Mautic ?

Le nœud Mautic expose 20 opérations sur 6 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
RessourceCreateGetGet ManyUpdateDeleteAddRemoveEdit Contact PointsEdit Do Not Contact ListSendSend Email
Campaign Contact✓✓
Company✓✓✓✓✓
Company Contact✓✓
Contact✓✓✓✓✓✓✓✓
Contact Segment✓✓
Segment Email✓

Campaign Contact

2 opérations
01

Add a campaign contact

campaignContact.add

Ce que tu vois dans n8n

Notes & cas d'usage

Fait entrer dans une campagne un contact déjà présent dans Mautic : les étapes de cette campagne se mettent à tourner pour lui.

Paramètres clés

  • Contact ID : l'identifiant du contact côté Mautic, en général repris du nœud précédent avec une expression comme {{ $json.id }}.
  • Campaign Name or ID : requis lui aussi. Les campagnes s'affichent dans une liste déroulante, et une expression fournit l'identifiant quand la campagne dépend de l'item traité.
Cas d'usage
une personne télécharge un livre blanc et rejoint la campagne qui correspond au sujet choisi.
02

Remove a campaign contact

campaignContact.remove

Ce que tu vois dans n8n

Notes & cas d'usage

Sort le contact d'une campagne. La fiche reste dans l'instance avec son historique, seule l'appartenance à la campagne s'arrête.

Paramètres clés

  • Contact ID : celui qui sort. La valeur vient presque toujours d'une étape précédente plutôt que d'une saisie à la main.
  • Campaign Name or ID : la campagne quittée, choisie dans la liste ou résolue par expression.
Cas d'usage
le contact a réservé un créneau, il quitte la campagne de relance avant que le message suivant ne parte.

Company

5 opérations
03

Create a company

company.create

Ce que tu vois dans n8n

Notes & cas d'usage

Une fiche entreprise apparaît dans Mautic, prête à regrouper les contacts qui y travaillent. Aucun champ n'est marqué obligatoire, alors remplis Company Name si tu comptes retrouver la fiche plus tard.

Paramètres clés

  • Company Name : le nom sous lequel l'entreprise apparaît dans Mautic.
  • Additional Fields : 12 entrées facultatives, dont Company Email, Phone, Website, Industry Name or ID, Annual Revenue et Number of Employees, plus Custom Fields pour les champs propres à ton instance.
  • Simplify : activé, la réponse revient allégée au lieu des données brutes de l'API.
Cas d'usage
un devis signé crée la fiche entreprise, puis les interlocuteurs y sont rattachés dans le nœud suivant, sans ressaisie.
04

Delete a company

company.delete

Ce que tu vois dans n8n

Notes & cas d'usage

Supprime une entreprise de l'instance. n8n n'affiche pas Company ID comme requis, pourtant l'opération ne vise rien sans lui.

Paramètres clés

  • Company ID : l'identifiant de l'entreprise à supprimer, repris d'une recherche ou d'une liste de doublons.
  • Simplify : garde une réponse courte quand le workflow attend seulement une confirmation.
Cas d'usage
un import a créé trois fois la même société, et un workflow de ménage supprime les identifiants en trop.
05

Get a company

company.get

Ce que tu vois dans n8n

Notes & cas d'usage

Lit une seule entreprise et passe ses données au nœud suivant. Rien n'est écrit, c'est donc l'opération idéale pour tester un credential fraîchement enregistré.

Paramètres clés

  • Company ID : la fiche à lire. Une expression garde le champ dynamique quand l'identifiant vient de l'item précédent.
  • Simplify : la réponse courte suffit la plupart du temps ; désactive-le si un nœud plus loin a besoin d'un champ que la version allégée laisse de côté.
Cas d'usage
vérifier qu'une entreprise existe déjà, pour éviter d'en créer une deuxième par erreur.
06

Get many companies

company.getAll

Ce que tu vois dans n8n

Notes & cas d'usage

L'opération de liste côté entreprises : un item par société, prêt à être parcouru par la suite du workflow.

Paramètres clés

  • Return All : coché, n8n enchaîne les pages de l'API Mautic jusqu'à la dernière entreprise ; décoché, Limit fixe le nombre d'entreprises renvoyées.
  • Search : une chaîne ou une commande de recherche Mautic, pour filtrer avant que la liste n'arrive dans n8n.
  • Order By Name or ID et Order Direction : la colonne de tri, et le sens asc ou desc.
Cas d'usage
un inventaire mensuel des entreprises, pour repérer celles dont l'email manque avant une campagne.
07

Update a company

company.update

Ce que tu vois dans n8n

Notes & cas d'usage

Écrit de nouvelles valeurs sur une entreprise existante. Seuls les champs remplis dans le nœud partent vers Mautic, le reste de la fiche ne bouge pas.

Paramètres clés

  • Company ID : l'entreprise à modifier, issue d'un company.getAll précédent ou de ta propre base.
  • Update Fields : 13 entrées, le même terrain qu'à la création plus Company Name, ce qui permet de renommer une société en un appel.
  • Overwrite With Blank : activé, les valeurs vides sont écrites dans les champs ; désactivé, elles sont ignorées, ce qui protège les données déjà en place.
Cas d'usage
une société change de nom après un rachat, une seule exécution met la fiche à jour.

Company Contact

2 opérations
08

Add a company contact

companyContact.add

Ce que tu vois dans n8n

Notes & cas d'usage

Deux identifiants, un lien : le contact est rattaché à l'entreprise, et Mautic sait qui travaille où.

Paramètres clés

  • Contact ID : l'identifiant du contact à rattacher.
  • Company ID : celui de l'entreprise. Aucun des deux n'est marqué requis dans l'interface, donc les deux valeurs viennent en pratique des nœuds précédents.
Cas d'usage
un nouvel interlocuteur signalé par l'équipe commerciale est rattaché à la fiche entreprise qui existe déjà.
09

Remove a company contact

companyContact.remove

Ce que tu vois dans n8n

Notes & cas d'usage

Le lien disparaît, les deux fiches restent. Pratique quand la relation change et que l'historique, lui, doit être conservé.

Paramètres clés

  • Contact ID : la personne à détacher.
  • Company ID : l'entreprise dont elle est détachée, indiquée par son identifiant et jamais par son nom.
Cas d'usage
un contact quitte la société, et le lien est retiré le jour où l'information remonte du CRM.

Contact

8 opérations
10

Create a contact

contact.create

Ce que tu vois dans n8n

Notes & cas d'usage

Crée le contact dans Mautic et le renvoie. Deux façons de le remplir : champ par champ, ou avec un corps JSON brut quand la donnée arrive structurée.

Paramètres clés

  • Email, First Name, Last Name : les champs d'identité, alimentés depuis l'item entrant.
  • Primary Company Name or ID : rattache tout de suite le nouveau contact à une entreprise.
  • JSON Parameters et Body : active le premier et les paramètres du contact voyagent en JSON.
  • Additional Fields : 23 entrées, dont Tag Names or IDs, Stage Name or ID, B2B or B2C, Prospect or Customer et Custom Fields.
Cas d'usage
après un salon, les badges scannés deviennent autant de contacts avec leur étiquette d'origine.
11

Delete a contact

contact.delete

Ce que tu vois dans n8n

Notes & cas d'usage

Efface un contact de Mautic. Le nœud ne demande aucune confirmation : un mauvais identifiant supprime la mauvaise personne.

Paramètres clés

  • Contact ID : le seul champ qui compte ici, et celui à revérifier avant d'activer le workflow.
Cas d'usage
les contacts de test créés pendant une recette sont supprimés une fois la recette terminée, sans passer par l'interface.
12

Edit a contact's points

contact.editContactPoint

Ce que tu vois dans n8n

Notes & cas d'usage

Mautic note ses contacts avec des points, et cette opération fait monter ou descendre ce score depuis un workflow, sur les signaux que produisent tes propres outils.

Paramètres clés

  • Contact ID : le contact dont le score bouge.
  • Action : add ou remove, le sens du mouvement.
  • Points : le nombre de points appliqués.
Cas d'usage
une inscription à un webinaire fait gagner 5 points au contact, assez pour le faire basculer dans la campagne commerciale.
13

Add/remove contacts from/to the do not contact list

contact.editDoNotContactList

Ce que tu vois dans n8n

Notes & cas d'usage

Marque un contact comme à ne plus contacter sur un canal, ou lève ce marquage. Le consentement vit dans Mautic, et cette opération sert à le respecter depuis un workflow.

Paramètres clés

  • Channel : requis, email ou sms.
  • Action : add place le contact sur la liste, remove l'en retire.
  • Contact ID : le contact concerné.
  • Reason To Do Not Contact : Unsubscribed, Bounced ou Manual, avec Comments pour le détail qu'un collègue relira dans six mois.
Cas d'usage
un désabonnement remonté depuis un autre outil ajoute l'adresse à la liste avec le motif Unsubscribed.
14

Get a contact

contact.get

Ce que tu vois dans n8n

Notes & cas d'usage

Récupère un contact et ses champs. C'est l'étape qui suit presque toujours un événement annonçant que quelqu'un a bougé.

Paramètres clés

  • Contact ID : le contact à lire, en général une expression qui pointe vers l'identifiant transporté par le nœud précédent.
  • Options : Minimal renvoie l'entité sans ses listes annexes, et RAW Data renvoie la réponse complète de l'API au lieu des seules valeurs de champs.
Cas d'usage
relire le contact à la réception d'un événement, puis laisser un nœud If décider si la suite s'exécute.
15

Get many contacts

contact.getAll

Ce que tu vois dans n8n

Notes & cas d'usage

Renvoie les contacts de l'instance sous forme de liste d'items. La plupart des exports et des audits d'une base Mautic commencent ici.

Paramètres clés

  • Return All : activé, n8n suit la pagination de l'API jusqu'au bout ; désactivé, Limit décide du nombre de contacts renvoyés.
  • Search : une commande de recherche Mautic réduit la liste, ce qui vaut mieux que de filtrer des milliers d'items plus loin.
  • Published Only : ne garde que les entités actuellement publiées.
Cas d'usage
un export complet de la base avant une migration, page après page, sans toucher à l'interface.
16

Send email to a contact

contact.sendEmail

Ce que tu vois dans n8n

Notes & cas d'usage

Envoie à un seul contact un email de campagne déjà construit dans Mautic. Le message reste celui que l'équipe marketing a préparé, le workflow choisit le destinataire et le moment.

Paramètres clés

  • Campaign Email Name or ID : requis, choisi parmi les emails de campagne de l'instance ou résolu par expression.
  • Contact ID : requis aussi, le destinataire unique de cet envoi.
Cas d'usage
une inscription confirmée déclenche l'email de bienvenue, sans recopier le texte ailleurs.
17

Update a contact

contact.update

Ce que tu vois dans n8n

Notes & cas d'usage

Met à jour un contact existant. Update Fields est la collection la plus large du nœud, 31 entrées, et c'est là que finit l'essentiel du travail d'enrichissement.

Paramètres clés

  • Contact ID : le contact à modifier.
  • Update Fields : les champs d'identité, plus Tag Names or IDs, Stage Name or ID, Owner ID, Has Purchased, Last Active et les Custom Fields.
  • JSON Parameters : activé, les paramètres passent dans Body en JSON, ce qui convient quand la charge utile est déjà construite en amont.
Cas d'usage
un changement d'adresse signalé au support met la fiche à jour sans ouvrir Mautic.

Contact Segment

2 opérations
18

Add a contact to a segment

contactSegment.add

Ce que tu vois dans n8n

Notes & cas d'usage

Range un contact dans un segment. Les segments sont les listes auxquelles Mautic envoie, donc cette opération transforme une décision prise dans le workflow en audience réelle.

Paramètres clés

  • Contact ID : requis, le contact qui rejoint la liste.
  • Segment Name or ID : requis, choisi parmi les segments de l'instance ou donné par son identifiant avec une expression, pratique quand le segment dépend d'un champ de l'item.
Cas d'usage
les clients d'une gamme précise rejoignent le segment qui recevra l'annonce de la nouvelle version.
19

Remove a contact from a segment

contactSegment.remove

Ce que tu vois dans n8n

Notes & cas d'usage

Retire le contact de la liste. Lancée juste avant un ajout, l'opération évite qu'une même personne se retrouve dans deux segments qui se contredisent.

Paramètres clés

  • Contact ID : requis, le contact à sortir.
  • Segment Name or ID : requis, le segment quitté.
Cas d'usage
un contact qui répond à l'enquête sort du segment des relances, et n'en reçoit plus.

Segment Email

1 opération
20

Send an email to a segment

segmentEmail.send

Ce que tu vois dans n8n

Notes & cas d'usage

Un champ, un envoi : l'email de segment part vers toute la liste qu'il vise. C'est la version en lot de l'envoi à un contact unique.

Paramètres clés

  • Segment Email Name or ID : requis, et seul paramètre de l'opération. Choisis l'email de segment dans la liste, ou passe son identifiant avec une expression quand l'envoi se décide en amont.
Cas d'usage
un nœud Schedule lance l'email du mardi matin, préparé la veille dans Mautic, sans que personne ne clique sur envoyer.
Besoin d'aide

Besoin d'aide pour automatiser Mautic avec n8n ?

L'équipe te répond directement.

Chaque message est lu par une personne.

FAQ

Mautic et n8n, les questions fréquentes

01L'intégration Mautic n8n est-elle gratuite ?
Oui côté n8n. Le nœud Mautic et le Mautic Trigger sont livrés avec n8n : rien à installer, aucun coût supplémentaire, que le workflow tourne sur n8n Cloud ou sur une instance auto-hébergée en Community Edition sous licence Sustainable Use. Un workflow se comporte de la même façon des deux côtés, donc un test monté sur ta machine part sur Cloud sans retoucher les nœuds. Ce que coûte Mautic lui-même dépend de la façon dont tu l'héberges, et cette page ne traite pas ce point. Les 20 opérations et le trigger webhook sont disponibles dès que le credential est enregistré.
02Quels credentials pour connecter Mautic à n8n ?
Deux méthodes, basic auth ou OAuth2, et dans les deux cas l'API doit d'abord être activée dans Mautic, sous Settings > Configuration > API Settings. La basic auth demande l'URL de l'instance, un Username et un Password, plus Enable HTTP basic auth? sur Yes dans ce même écran. OAuth2 demande un Client ID, un Client Secret et la même URL de base : tu les génères en créant un nouveau client sous Configuration > Settings > API Credentials, en collant l'OAuth Callback URL de n8n dans le champ Redirect URI. Le credential se crée une fois dans le menu Credentials, et les deux nœuds le proposent ensuite dans leur liste.
03Quelles limites a le nœud Mautic ?
Ça dépend de ce que tu cherches. Le nœud expose 20 opérations sur 6 ressources : contacts, entreprises, lien entre les deux, segments, campagnes et emails de segment. Tout le reste de l'API Mautic passe par le nœud HTTP Request, qui réutilise le même credential avec son authentification prédéfinie. Les opérations de liste s'arrêtent à Limit tant que Return All n'est pas coché, et Return All enchaîne ensuite les pages de l'API jusqu'au bout. Dernier détail qui piège souvent : Contact ID et Company ID ne sont pas marqués comme requis dans l'interface, alors que l'opération ne fait rien sans eux.
04Le Mautic Trigger réagit-il en temps réel ?
Oui. Le Mautic Trigger fonctionne par webhook : n8n enregistre une URL auprès de l'instance à l'activation du workflow, Mautic appelle cette URL quand un événement coché se produit, et l'exécution démarre en quelques secondes. Aucun intervalle à régler, aucun décalage à rattraper. Les événements se choisissent dans Event Names or IDs, un champ requis, et il n'existe pas de joker pour tout attraper d'un coup. Quand Mautic met plusieurs événements en file et les envoie dans le même appel, Events Order décide du sens de lecture : DESC du plus récent au plus ancien, ASC dans l'autre sens.
05n8n ou Make pour Mautic ?
Ça dépend surtout de l'endroit où tes données doivent rester. Mautic s'héberge en général chez toi, et n8n accepte le même terrain : auto-hébergement avec Docker ou npm, ou n8n Cloud quand l'hébergement n'est pas ton sujet. Make n'a pas d'option d'auto-hébergement et se facture à l'opération, ce qui change le calcul dès qu'un workflow boucle sur une grosse base de contacts. La logique visuelle diffère aussi : Make enchaîne des modules, n8n dessine un graphe avec des branches. Aucun des deux n'a tort. Tu choisis sur l'hébergement, la maîtrise des données et le modèle de coût.