Intégration Brevo n8nAutomatiser Brevo avec n8n.
Chaque email transactionnel laisse une trace, et n8n sait la lire. L'intégration Brevo n8n ouvre 15 opérations réparties sur 4 ressources : contacts, attributs de contact, emails et expéditeurs. Le Brevo Trigger écoute 12 événements d'email. Tout se pilote depuis un workflow.
Avis vérifiés sur Trustpilot · Agence IA, automatisation & growth
Que fait vraiment l'intégration Brevo n8n ?
Deux nœuds sont livrés avec n8n pour Brevo. Le nœud Brevo appelle l'API de Brevo à ta place, avec 15 opérations réparties entre les contacts, les attributs de contact, les emails transactionnels et les expéditeurs. Le Brevo Trigger, lui, démarre un workflow quand Brevo signale quelque chose sur un email, parmi 12 événements. Un trigger, c'est simplement le nœud qui décide du moment où un workflow part. Et le credential créé pour l'un fonctionne pour l'autre.
Dans la pratique, trois familles de workflows reviennent tout le temps.
L'envoi d'abord. Le workflow récupère une commande, une inscription ou un ticket, puis email.sendTemplate déclenche le template Brevo correspondant, avec ses Template Parameters remplis depuis l'item entrant. Face à une simple boîte mail comme Gmail, la différence tient à un point : la mise en forme reste dans Brevo, n8n ne fournit que les valeurs.
L'hygiène de base ensuite. contact.upsert écrit le contact qu'il existe déjà ou non. Un formulaire, une ligne de Google Sheets et une fiche CRM finissent donc sur une seule fiche propre, au lieu de trois quasi doublons qu'il faudra fusionner un jour. Et attribute.create déclare les champs avant que quoi que ce soit essaie de les remplir.
La réaction, enfin. Les 12 événements du trigger racontent ce qui est arrivé à chaque email transactionnel, et le workflow répond. Un hard bounce neutralise l'adresse, un clic monte un score, une désinscription se propage vers les autres outils qui détiennent le même contact, par exemple Mautic.
Restent les bordures. Le nœud couvre 4 ressources, pas une de plus : les listes de contacts, les campagnes marketing, les SMS et les statistiques sont en dehors. Quand l'un de ces besoins arrive, le nœud HTTP Request appelle n'importe quel endpoint de l'API Brevo et réutilise le même credential via l'authentification prédéfinie. La clé n'est jamais recopiée ailleurs. Ce repli est la façon normale d'étendre le nœud, pas un bricolage.
Un dernier point avant de construire : le mécanisme du Brevo Trigger n'est pas documenté. Prévois donc que le workflow doit être actif pour qu'il écoute, et garde un chemin manuel pour rejouer un traitement. Si c'est n8n qui est nouveau et pas Brevo, la Formation n8n reprend credentials, expressions et gestion d'erreur dans l'ordre où cette page s'en sert. Pour situer n8n face aux autres plateformes, l'Avis n8n est plus utile qu'un comparatif de logos.
Comment connecter Brevo à n8n ?
- 01
Générer la clé API dans Brevo
Il faut d'abord un compte développeur Brevo : c'est le prérequis indiqué dans la documentation du credential n8n. De là, tu crées une nouvelle clé en suivant le guide de démarrage rapide de l'API Brevo. Cette clé est le seul secret nécessaire : le credential Brevo dans n8n ne propose qu'une méthode d'authentification, la clé API. Pas de parcours OAuth, pas de scopes à cocher, pas d'URL de redirection à déclarer.
- 02
Enregistrer la clé comme credential n8n
Dans n8n, ouvre le menu Credentials et crée un credential Brevo. Un credential, c'est un jeu de secrets enregistré une fois, que les nœuds empruntent au moment de s'exécuter : la clé vit à un seul endroit plutôt que dans chaque workflow. Le formulaire demande un unique champ, API Key. Colle la valeur générée côté Brevo, enregistre, et donne au credential un nom que tu reconnaîtras dans une liste déroulante dans six mois.
- 03
Sélectionner le credential dans le nœud
Pose un nœud Brevo sur le canevas, ou un Brevo Trigger, et choisis dans sa liste le credential enregistré. La même entrée sert aux deux nœuds et à tous les workflows suivants, donc cette étape ne se refait jamais. Sur le nœud, tu choisis ensuite une ressource puis une opération. Sur le trigger, tu renseignes la Resource, tu coches les événements sous Trigger On, puis tu actives le workflow.
Qu'est-ce qui déclenche un workflow depuis Brevo ?
Brevo Trigger est le nœud qui démarre un workflow quand quelque chose se passe dans Brevo. Il couvre 12 événements, listés ci-dessous par famille. Tu actives le workflow et chaque événement reçu devient une exécution.
Ce que tu vois dans n8n
Tous les événements, par famille
Une ligne par objet, une puce par action. L'événement à cocher dans le nœud s'écrit objet.action ; survole une puce pour lire quand il se déclenche.
blocked.*1blocked.blocked
click.*1click.click
deferred.*1deferred.deferred
delivered.*1delivered.delivered
hard.*1invalid.*1invalid.invalid
opened.*1opened.opened
request.*1request.request
soft.*1spam.*1spam.spam
unique.*1unsubscribed.*1unsubscribed.unsubscribed
Notes de configuration
01Set Up the Brevo Trigger
Deux paramètres configurent le Brevo Trigger, et tous les deux pèsent plus lourd qu'il n'y paraît.
Paramètres clés
- Resource : requis, il fixe ce que le trigger surveille avant même de parler d'événements.
- Trigger On : la liste des événements auxquels le workflow réagit, cochés un par un. Aucune entrée « tout » n'existe : un événement non coché n'arrive jamais sur le canevas, et en ajouter un plus tard demande de rouvrir le trigger, pas les nœuds qui suivent.
02Email Sent, Delivered and Deferred
La distribution a trois points de contrôle, et chacun répond à une question différente sur le même message.
Paramètres clés
- Trigger On : coche
requestpour Email Sent, déclenché quand l'email transactionnel part,deliveredpour Email Delivered, quand il arrive à destination, etdeferredpour Email Deferred, quand le serveur destinataire le repousse à plus tard.
request dans un tableur, et la preuve d'envoi existe quoi que raconte le client trois semaines après. Une revue de délivrabilité s'appuie plutôt sur deferred : un message sans cesse repoussé désigne le domaine d'envoi, pas le destinataire. Croiser envoyé et délivré dans le même workflow donne aussi un contrôle simple : ce qui part sans jamais arriver mérite un coup d'œil.03Email Opened, Unique Open and Clicked
L'engagement se lit sur trois événements, et en confondre deux fausse tous les tableaux construits ensuite.
Paramètres clés
- Trigger On :
openedse déclenche à chaque ouverture de l'email transactionnel,uniqueOpenedà la première ouverture par ce destinataire,clickau clic sur un lien du message.
uniqueOpened pour compter des personnes et opened pour compter des lectures. Un client qui rouvre sa facture quatre fois reste une personne, pas quatre. Et branche click sur quelque chose qui agit : une colonne de score, une relance, une notification dans Slack pour le commercial qui suit le compte. Le clic sur un transactionnel signale une intention, c'est le plus exploitable des trois. Une ouverture seule reste un signal faible, surtout sur un reçu que le destinataire rouvre deux fois par réflexe.04Hard Bounce, Soft-Bounce, Blocked and Invalid
Quatre événements signalent que le message n'est pas arrivé, et la bonne réaction diffère à chaque fois.
Paramètres clés
- Trigger On :
hardBouncepour un rebond définitif,softBouncepour un rebond temporaire,blockedquand l'email transactionnel est bloqué,invalidquand l'adresse est invalide.
contact.update et cesse d'écrire dessus. Un soft bounce, c'est temporaire, et ça mérite un compteur plutôt qu'une suppression : trois d'affilée sur la même adresse, c'est un signal, un seul, c'est du bruit. Les emails bloqués gagnent à remonter à un humain, parce que la cause est presque toujours côté envoi. Regrouper les quatre événements dans un seul workflow, avec un aiguillage sur le nom de l'événement, évite d'entretenir quatre flux presque identiques.05Email Marked Spam and Unsubscribed
Une plainte et un désabonnement mettent tous les deux fin à la conversation, et tous les deux doivent être respectés partout en même temps.
Paramètres clés
- Trigger On :
spamse déclenche quand un email transactionnel est marqué comme spam,unsubscribedquand le destinataire se désabonne.
Que sait faire le nœud Brevo ?
Le nœud Brevo expose 15 opérations sur 4 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 | Send | Send Template | Create or Update |
|---|---|---|---|---|---|---|---|---|
| Contact | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ||
| Contact Attribute | ✓ | ✓ | ✓ | ✓ | ||||
| ✓ | ✓ | |||||||
| Sender | ✓ | ✓ | ✓ |
Sommaire des opérations
Contact
6 opérationsCreate a contact
contact.createCe que tu vois dans n8n
Notes & cas d'usage
Ajoute un contact dans Brevo et renvoie la fiche qui vient d'être créée. Aucun champ n'est marqué requis sur cette opération : un appel vide passe donc quand même, et laisse un contact sans adresse.
Paramètres clés
- Email : l'adresse du contact, au format
name@email.comsuggéré par le champ, le plus souvent{{ $json.email }}quand elle vient d'un formulaire ou d'un nœud précédent. - Contact Attributes : le tableau d'attributs ajoutés avec le contact, un nom et une valeur par entrée.
Upsert a contact
contact.upsertCe que tu vois dans n8n
Notes & cas d'usage
Cherche l'adresse d'abord, puis crée le contact ou met à jour celui qui existe. C'est l'opération qui empêche une base de se remplir de quasi doublons quand la même personne remplit deux formulaires.
Paramètres clés
- Email : requis ici, contrairement à Create. Il sert d'identifiant, donc une valeur vide bloque l'exécution du nœud au lieu d'écrire une fiche anonyme.
- Contact Attributes : le tableau d'attributs à mettre à jour, appliqué que le contact vienne d'être créé ou qu'il existait déjà.
Delete a contact
contact.deleteCe que tu vois dans n8n
Notes & cas d'usage
Supprime le contact de Brevo. Il n'y a ni corbeille ni retour en arrière, donc cette opération se place en bout de branche, une fois la décision prise, jamais au milieu d'un nettoyage automatique.
Paramètres clés
- Contact Identifier : l'email encodé en URL, l'identifiant du contact, ou la valeur de son attribut SMS. Les trois fonctionnent, ce qui dépanne quand la demande arrive avec un numéro de téléphone plutôt qu'une adresse.
Get a contact
contact.getCe que tu vois dans n8n
Notes & cas d'usage
Lit un contact et renvoie ses attributs. C'est le deuxième nœud habituel après un trigger qui ne transmet qu'une adresse.
Paramètres clés
- Contact Identifier : requis. Accepte l'email encodé en URL, l'identifiant du contact ou la valeur de son attribut SMS, souvent écrit sous forme d'expression, par exemple
{{ $json.email }}, pour que la valeur suive l'item dans le workflow.
Get many contacts
contact.getAllCe que tu vois dans n8n
Notes & cas d'usage
Sort un lot de contacts de Brevo, un item par contact, pour les exports et les audits plutôt que pour une recherche unitaire.
Paramètres clés
- Return All : activé, n8n enchaîne les pages de l'API jusqu'au dernier contact. Désactivé, Limit fixe le nombre maximal renvoyé.
- Filters : réduit l'ensemble avant qu'il n'arrive sur le canevas.
- Sort : trie par date de création, ascendant ou descendant.
- Modified Since : ne garde que les contacts modifiés après une date UTC encodée en URL, au format
YYYY-MM-DDTHH:mm:ss.SSSZ.
Update a contact
contact.updateCe que tu vois dans n8n
Notes & cas d'usage
Modifie les valeurs d'attributs d'un contact existant, et échoue au lieu d'en créer un si l'identifiant ne correspond à personne. Cette rigidité est utile : elle sert quand la fiche doit être là.
Paramètres clés
- Contact Identifier : requis. L'email encodé en URL, l'identifiant du contact ou la valeur de l'attribut SMS.
- Attributes : le tableau d'attributs à mettre à jour, chacun avec son nom et sa nouvelle valeur.
Contact Attribute
4 opérationsCreate an attribute
attribute.createCe que tu vois dans n8n
Notes & cas d'usage
Déclare un nouvel attribut de contact dans le compte, c'est-à-dire le champ que les opérations de contact rempliront ensuite. Quatre valeurs sont requises, plus que sur n'importe quelle autre opération du nœud.
Paramètres clés
- Category : requis, parmi
normal,transactional,calculated,categoryetglobal. - Name : requis, le nom de l'attribut.
- Type : requis,
text,date,floatouboolean. - Value : requis, la valeur de l'attribut.
Update an attribute
attribute.updateCe que tu vois dans n8n
Notes & cas d'usage
Modifie un attribut déjà présent dans le compte. Le détail intéressant se cache dans les catégories : seules trois des cinq sont proposées ici, donc un attribut normal ou transactionnel ne se remodèle pas par ce chemin.
Paramètres clés
- Category :
calculated,categoryouglobal. - Name : le nom de l'attribut existant, qui doit correspondre exactement.
- Value : la valeur à mettre à jour.
- Contact Attributes : sous Update Fields, la liste des valeurs et libellés que l'attribut peut prendre.
Delete an attribute
attribute.deleteCe que tu vois dans n8n
Notes & cas d'usage
Retire un attribut du modèle de contact. Tous les contacts perdent ce champ, donc mieux vaut exporter d'abord et supprimer ensuite.
Paramètres clés
- Category : la famille à laquelle appartient l'attribut, parmi
normal,transactional,calculated,categoryetglobal. Les cinq catégories sont disponibles ici, contrairement à l'opération de mise à jour. - Name : l'attribut à retirer.
Get many attributes
attribute.getAllCe que tu vois dans n8n
Notes & cas d'usage
Liste les attributs déclarés dans le compte. C'est ainsi qu'un workflow vérifie ce qui existe avant d'essayer d'écrire dedans.
Paramètres clés
- Return All : activé, tous les attributs reviennent, sur autant de pages d'API que nécessaire. Désactivé, Limit fixe le nombre maximal renvoyé.
Send a transactional email
email.sendCe que tu vois dans n8n
Notes & cas d'usage
Envoie un email transactionnel composé dans le nœud, donc un contenu qui vit dans le workflow et pas dans Brevo.
Paramètres clés
- Sender et Receipients : requis tous les deux, et un champ vide arrête l'exécution.
- Send HTML : bascule le corps entre Text Content et HTML Content.
- Subject : l'objet du message.
- Receipients CC et Receipients BCC : destinataires supplémentaires, sous Additional Fields.
- Email Tags : étiquette l'envoi pour le retrouver plus tard, à côté d'Attachments dans la même collection.
Send an email with an existing Template
email.sendTemplateCe que tu vois dans n8n
Notes & cas d'usage
Utilise un template conçu dans Brevo au lieu de HTML tapé dans n8n, ce qui laisse la mise en forme entre les mains de ceux qui tiennent la marque.
Paramètres clés
- Receipients : requis, le seul champ sur lequel le nœud insiste.
- Template ID : une liste déroulante alimentée par le compte, donc aucun identifiant à retenir.
- Template Parameters : sous Additional Fields, le jeu d'attributs qui personnalise le template, typiquement des expressions comme
{{ $json.order_id }}. - Attachments et Email Tags : fichiers à joindre et étiquettes de recherche.
Sender
3 opérationsCreate a sender
sender.createCe que tu vois dans n8n
Notes & cas d'usage
Enregistre un expéditeur dans le compte, l'identité sous laquelle partiront les emails transactionnels. Les deux champs sont requis, ce qui en fait l'opération la plus simple du nœud à réussir.
Paramètres clés
- Name : requis, le nom affiché à côté de l'adresse chez le destinataire.
- Email : requis, l'adresse de l'expéditeur, au format
name@email.com.
Delete a sender
sender.deleteCe que tu vois dans n8n
Notes & cas d'usage
Retire un expéditeur du compte. Tout ce qui pointe encore vers cette identité doit être corrigé avant, puisque les opérations d'envoi nomment un expéditeur explicitement.
Paramètres clés
- Sender ID : l'identifiant de l'expéditeur à supprimer, pas son adresse. Get Many Senders reste la façon habituelle de trouver cet identifiant, souvent enchaîné en
{{ $json.id }}directement dans ce champ.
Get many senders
sender.getAllCe que tu vois dans n8n
Notes & cas d'usage
Renvoie les expéditeurs disponibles dans le compte, avec leurs identifiants. C'est ce qui rend l'opération de suppression praticable.
Paramètres clés
- Return All : activé, le nœud parcourt les pages de l'API jusqu'à la liste complète. Désactivé, Limit plafonne le nombre d'expéditeurs renvoyés.
Besoin d'aide pour automatiser Brevo avec n8n ?
L'équipe te répond directement.
Chaque message est lu par une personne.
