Guides

Brevo API : guide complet pour les développeurs 2025

Antoine Mercier

Antoine Mercier

Expert email marketing

|
calendar_today
|
schedule 10 min de lecture
Brevo API : guide complet pour les développeurs 2025

👉 Essayer Brevo gratuitement

Plan gratuit jusqu’à 300 emails/jour — sans carte bancaire

Essayer Brevo gratuitement →

✅ L’API Brevo est complète, bien documentée et supporte Python, Node.js, PHP, Go, Ruby, Java
✅ Idéale pour les emails transactionnels depuis vos apps avec tracking complet
⚠️ Pour les volumes > 100K emails/jour, discutez de limites de débit avec le support Brevo

Essayez Brevo gratuitement — L outil email #1 pour les PME. Decouvrir Brevo →

Brevo api documentation est au cœur de cet article. Brevo api documentation est au cœur de cet article. Brevo api documentation est au cœur de cet article. L’API Brevo couvre deux cas d’usage majeurs : l’envoi d’emails transactionnels depuis vos applications, et la gestion programmatique de vos listes et campagnes marketing. Voici comment bien l’utiliser.

Authentification

Toutes les requêtes API Brevo utilisent une clé API dans le header HTTP.

Générer votre clé : Brevo → Paramètres → SMTP & API → Clés API → Créer

GET https://api.brevo.com/v3/account
Accept: application/json
api-key: VOTRE_CLE_API

Conservez votre clé dans les variables d’environnement — jamais en dur dans le code.

Envoyer un email transactionnel

Avec le SDK officiel Python

pip install sib-api-v3-sdk
import sib_api_v3_sdk
from sib_api_v3_sdk.rest import ApiException

configuration = sib_api_v3_sdk.Configuration()
configuration.api_key['api-key'] = 'VOTRE_CLE_API'

api_instance = sib_api_v3_sdk.TransactionalEmailsApi(
    sib_api_v3_sdk.ApiClient(configuration)
)

send_smtp_email = sib_api_v3_sdk.SendSmtpEmail(
    to=[{"email": "client@exemple.com", "name": "Jean Dupont"}],
    template_id=42,  # ID du template dans Brevo
    params={"prenom": "Jean", "commande": "#12345"},
    sender={"email": "noreply@votre-site.com", "name": "Votre Boutique"}
)

try:
    response = api_instance.send_transac_email(send_smtp_email)
    print(f"Email envoyé, ID: {response.message_id}")
except ApiException as e:
    print(f"Erreur: {e}")

Avec Node.js

npm install @getbrevo/brevo
const SibApiV3Sdk = require('@getbrevo/brevo');

const apiInstance = new SibApiV3Sdk.TransactionalEmailsApi();
apiInstance.authentications['api-key'].apiKey = 'VOTRE_CLE_API';

const sendSmtpEmail = new SibApiV3Sdk.SendSmtpEmail();
sendSmtpEmail.to = [{email: 'client@exemple.com', name: 'Jean Dupont'}];
sendSmtpEmail.templateId = 42;
sendSmtpEmail.params = {prenom: 'Jean', commande: '#12345'};
sendSmtpEmail.sender = {email: 'noreply@votre-site.com'};

apiInstance.sendTransacEmail(sendSmtpEmail)
  .then(data => console.log('Envoyé:', data.messageId))
  .catch(err => console.error('Erreur:', err));

Gérer les contacts

Créer ou mettre à jour un contact

api_instance = sib_api_v3_sdk.ContactsApi(
    sib_api_v3_sdk.ApiClient(configuration)
)

create_contact = sib_api_v3_sdk.CreateContact(
    email='nouveau@exemple.com',
    attributes={
        'PRENOM': 'Marie',
        'NOM': 'Dupont',
        'PLAN': 'pro',
        'DATE_INSCRIPTION': '2025-04-03'
    },
    list_ids=[5],  # ID de la liste dans Brevo
    update_enabled=True  # Met à jour si existe déjà
)

try:
    api_instance.create_contact(create_contact)
except ApiException as e:
    print(e)

Déclencher un événement custom pour les automatisations

track_event = sib_api_v3_sdk.TrackEvent(
    email='client@exemple.com',
    event='achat_complete',
    eventdata=sib_api_v3_sdk.TrackEventEventdata(
        data={'montant': 99.90, 'produit': 'Formation Email Marketing'}
    )
)

event_api = sib_api_v3_sdk.TrackingApi(
    sib_api_v3_sdk.ApiClient(configuration)
)
event_api.track_event(track_event)

Cet événement peut déclencher une automatisation Brevo configurée pour réagir à l’événement ‘achat_complete’.

Les webhooks : réagir aux événements email

Les webhooks vous permettent d’être notifié en temps réel quand quelque chose se passe côté email.

Événements disponibles :

Configurer les webhooks : Brevo → Paramètres → Webhooks → Ajouter

Exemple de payload reçu :

{
  "event": "clicked",
  "email": "client@exemple.com",
  "id": 12345,
  "date": "2025-04-03T14:22:00Z",
  "url": "https://votre-site.com/voir-offre",
  "messageId": "<abc123@smtp.brevo.com>"
}

Cas d’usage concret : Quand un contact clique sur « Voir la proposition » dans un email → webhook → votre CRM crée une tâche « Appeler ce lead maintenant » → Slack notification à votre commercial.

Templates d’emails dans Brevo

Pour les emails transactionnels, créez des templates dans l’interface Brevo et référencez-les par leur ID dans l’API. Avantages :

Utiliser les variables dans les templates :

Dans l’éditeur Brevo, utilisez : {{ params.prenom }} et {{ params.montant }}.

Dans l’API, passez ces variables dans l’objet params :

params={"prenom": "Jean", "montant": "99.90€"}

Limites de débit (rate limiting)

Plan Emails transactionnels/jour Requêtes API/heure
Gratuit 300 50
Starter Selon plan 200
Business Selon plan 500
Enterprise Sur mesure 1000+

Pour les pics de volume (lancement, Black Friday), prévenez le support Brevo — ils peuvent augmenter temporairement vos limites.

Bonnes pratiques

Gestion des erreurs : Implémentez une logique de retry avec backoff exponentiel pour les erreurs 429 (rate limit) et 503 (service indisponible). Pour les erreurs 400 (mauvais paramètres) et 422 (email invalide), ne retentez pas — corrigez le code.

Logging : Conservez le messageId de chaque email envoyé. Il vous permettra de retrouver l’email dans Brevo et de diagnostiquer les problèmes de délivrabilité.

Variables d’environnement : Jamais la clé API en dur dans le code. .env ou secrets manager cloud.

Guide pratique pas à pas

Étape 1 : Configuration initiale de votre compte Brevo

La configuration initiale prend environ 30 minutes et conditionne votre délivrabilité long terme. Ne la sautez pas :

Authentification de domaine (OBLIGATOIRE) :

  1. Connectez-vous à Brevo → Paramètres → Expéditeurs et IP
  2. Ajoutez votre domaine d’envoi (ex: contact@votreentreprise.fr)
  3. Copiez les enregistrements SPF, DKIM et DMARC fournis
  4. Ajoutez ces enregistrements dans la zone DNS de votre hébergeur (OVH, Gandi, Ionos…)
  5. Attendez 24-48h pour la propagation DNS
  6. Vérifiez le statut dans Brevo (tout doit passer au vert)

Sans cette étape, vos emails risquent de finir en spam sur Gmail, Outlook et Orange Mail.

Étape 2 : Import et nettoyage de vos contacts

Bonnes pratiques d’import :

Outil de nettoyage recommandé : Brevo propose un validateur d’emails intégré qui identifie les adresses invalides, jetables ou à risque.

Étape 3 : Création de votre premier formulaire d’inscription

Un formulaire d’inscription bien conçu peut multiplier par 5 votre taux de conversion visiteur → abonné :

Étape 4 : Création et envoi de votre première campagne

Checklist avant envoi :

Paramétrage de l’envoi :

Pourquoi choisir Brevo pour votre email marketing ?

L’avantage compétitif décisif : contacts illimités

La quasi-totalité des concurrents facturent en fonction du nombre de contacts, ce qui peut faire exploser votre budget si votre liste croît rapidement. Brevo facture uniquement sur le volume d’emails envoyés, ce qui représente une économie de 40 à 70% pour les bases de données importantes peu sollicitées.

Exemple concret : Vous avez 30 000 contacts mais n’envoyez qu’une newsletter mensuelle. Chez Mailchimp, vous payez le plan « Essentials » à 245€/mois. Chez Brevo, vous payez le plan Business à 79€/mois. Économie annuelle : 1 992€.

La conformité RGPD : un enjeu business, pas juste légal

En 2023, la CNIL a infligé 101 millions d’euros d’amendes à des entreprises françaises pour non-conformité RGPD dans leurs pratiques d’email marketing. Brevo vous protège avec :

Guide pratique pas à pas

Étape 1 : Configuration initiale de votre compte Brevo

La configuration initiale prend environ 30 minutes et conditionne votre délivrabilité long terme. Ne la sautez pas :

Authentification de domaine (OBLIGATOIRE) :

  1. Connectez-vous à Brevo → Paramètres → Expéditeurs et IP
  2. Ajoutez votre domaine d’envoi (ex: contact@votreentreprise.fr)
  3. Copiez les enregistrements SPF, DKIM et DMARC fournis
  4. Ajoutez ces enregistrements dans la zone DNS de votre hébergeur (OVH, Gandi, Ionos…)
  5. Attendez 24-48h pour la propagation DNS
  6. Vérifiez le statut dans Brevo (tout doit passer au vert)

Sans cette étape, vos emails risquent de finir en spam sur Gmail, Outlook et Orange Mail.

Étape 2 : Import et nettoyage de vos contacts

Bonnes pratiques d’import :

Outil de nettoyage recommandé : Brevo propose un validateur d’emails intégré qui identifie les adresses invalides, jetables ou à risque.

Étape 3 : Création de votre premier formulaire d’inscription

Un formulaire d’inscription bien conçu peut multiplier par 5 votre taux de conversion visiteur → abonné :

Étape 4 : Création et envoi de votre première campagne

Checklist avant envoi :

Paramétrage de l’envoi :

Guide pratique pas à pas

Étape 1 : Configuration initiale de votre compte Brevo

La configuration initiale prend environ 30 minutes et conditionne votre délivrabilité long terme. Ne la sautez pas :

Authentification de domaine (OBLIGATOIRE) :

  1. Connectez-vous à Brevo → Paramètres → Expéditeurs et IP
  2. Ajoutez votre domaine d’envoi (ex: contact@votreentreprise.fr)
  3. Copiez les enregistrements SPF, DKIM et DMARC fournis
  4. Ajoutez ces enregistrements dans la zone DNS de votre hébergeur (OVH, Gandi, Ionos…)
  5. Attendez 24-48h pour la propagation DNS
  6. Vérifiez le statut dans Brevo (tout doit passer au vert)

Sans cette étape, vos emails risquent de finir en spam sur Gmail, Outlook et Orange Mail.

Étape 2 : Import et nettoyage de vos contacts

Bonnes pratiques d’import :

Outil de nettoyage recommandé : Brevo propose un validateur d’emails intégré qui identifie les adresses invalides, jetables ou à risque.

Étape 3 : Création de votre premier formulaire d’inscription

Un formulaire d’inscription bien conçu peut multiplier par 5 votre taux de conversion visiteur → abonné :

Étape 4 : Création et envoi de votre première campagne

Checklist avant envoi :

Paramétrage de l’envoi :

Essayez Brevo gratuitement — L outil email #1 pour les PME. Decouvrir Brevo →

[IMAGE:api-integration-developer-code-diagram-indigo-tech-icons-flat-design-no-people]

Articles connexes

📊 Voir notre comparatif complet des outils email

Voir notre comparatif complet des outils email →

A lire aussi

Comparatif Email Marketing 2026
Compare les meilleurs outilsNotre Methodologie
Comment nous testons les outilsTous nos Articles
Guides et tutoriels emailing

Articles similaires

Antoine Mercier

A propos de l'auteur

Antoine Mercier

Expert email marketing

Specialiste en email marketing depuis plus de 10 ans, Antoine a aide des centaines d'entreprises a optimiser leurs campagnes emailing. Il teste et compare les meilleurs outils du marche pour vous guider dans votre choix.

article 50+ articles publies · verified 12 outils testes
email

Decouvrez notre comparatif des meilleurs outils email marketing

Nous avons teste et compare les 8 meilleures solutions pour vous aider a choisir l'outil adapte a vos besoins.

Voir le comparatif arrow_forward

Articles similaires

Brevo automatisation : créer des séquences email qui convertissent
Guides

Brevo automatisation : créer des séquences email qui convertissent

✅ Les automatisations Brevo sont complètes dès le plan Starter (25€/mois) ✅ Le builder visuel type flow chart est intuitif...

calendar_today
Guides

Email marketing pour les agences : gérer plusieurs clients sur Brevo

✅ Le chat en direct sur un site augmente les conversions de 20-40% ✅ Brevo Conversations combine chat, email et...

calendar_today
Guides

Email marketing pour yoga et bien-être : développer sa communauté

✅ La newsletter yoga crée un lien fort avec la communauté — au-delà du cours ✅ Les séquences d’email pour...

calendar_today
Recommandé par ContentLab Hub — Comparatifs outils SaaS indépendants
↑
Ce site contient des liens affiliés. En utilisant ces liens, vous ne payez pas plus cher mais nous percevons une commission qui nous aide à maintenir ce site.