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
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.
Comment connecter Mautic à n8n ?
- 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.
- 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.
- 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.
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 Trigger
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.
02Follow Up With the Mautic Node
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.
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.
| Ressource | Create | Get | Get Many | Update | Delete | Add | Remove | Edit Contact Points | Edit Do Not Contact List | Send | Send Email |
|---|---|---|---|---|---|---|---|---|---|---|---|
| Campaign Contact | ✓ | ✓ | |||||||||
| Company | ✓ | ✓ | ✓ | ✓ | ✓ | ||||||
| Company Contact | ✓ | ✓ | |||||||||
| Contact | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | |||
| Contact Segment | ✓ | ✓ | |||||||||
| Segment Email | ✓ |
Sommaire des opérations
Campaign Contact
2 opérationsAdd a campaign contact
campaignContact.addCe 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é.
Remove a campaign contact
campaignContact.removeCe 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.
Company
5 opérationsCreate a company
company.createCe 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.
Delete a company
company.deleteCe 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.
Get a company
company.getCe 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é.
Get many companies
company.getAllCe 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.
Update a company
company.updateCe 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.getAllpré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.
Company Contact
2 opérationsAdd a company contact
companyContact.addCe 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.
Remove a company contact
companyContact.removeCe 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.
Contact
8 opérationsCreate a contact
contact.createCe 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.
Delete a contact
contact.deleteCe 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.
Edit a contact's points
contact.editContactPointCe 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.
Add/remove contacts from/to the do not contact list
contact.editDoNotContactListCe 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.
Get a contact
contact.getCe 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.
Get many contacts
contact.getAllCe 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.
Send email to a contact
contact.sendEmailCe 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.
Update a contact
contact.updateCe 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.
Contact Segment
2 opérationsAdd a contact to a segment
contactSegment.addCe 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.
Remove a contact from a segment
contactSegment.removeCe 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é.
Segment Email
1 opérationSend an email to a segment
segmentEmail.sendCe 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.
Besoin d'aide pour automatiser Mautic avec n8n ?
L'équipe te répond directement.
Chaque message est lu par une personne.
