Brevo API : guide complet pour développeurs et intégrations avancées

✅ L’API Brevo est RESTful, bien documentée et disponible avec des SDK officiels
✅ Envoi transactionnel via API : le cas d’usage le plus courant et le plus simple
⚠️ Chaque appel API consomme votre quota d’emails — planifiez selon vos volumes

---

Brevo API : tout ce qu’un développeur doit savoir

Brevo api guide développeur intégration est au cœur de cet article. Brevo api guide développeur intégration est au cœur de cet article. Brevo api guide développeur intégration est au cœur de cet article. Vous développez une application et avez besoin d’envoyer des emails (confirmation d’inscription, réinitialisation de mot de passe, notification de transaction) ? L’API Brevo est probablement la solution la plus simple et abordable du marché.

[IMAGE:code informatique sur écran avec terminal et éditeur sans personnes]

Authentification et premiers pas

L’API Brevo utilise une clé API pour l’authentification. Récupérez-la dans :
Paramètres → Clés API → Créer une clé API

Toutes les requêtes doivent inclure le header :

api-key: VOTRE_CLE_API
content-type: application/json

Base URL : https://api.brevo.com/v3/

SDK officiels disponibles

Brevo fournit des SDK dans les langages principaux :

• Python : pip install sib-api-v3-sdk
• Node.js : npm install @getbrevo/brevo
• PHP : composer require getbrevo/brevo-php
• Ruby, Go, Java : également disponibles

Envoyer un email transactionnel

En Python :

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@example.com", "name": "Jean Dupont"}],
    template_id=1,  # ID du template dans Brevo
    params={"PRENOM": "Jean", "COMMANDE": "#12345"}
)

response = api_instance.send_transac_email(send_smtp_email)

En JavaScript (Node.js) :

const Brevo = require('@getbrevo/brevo');
const apiInstance = new Brevo.TransactionalEmailsApi();
apiInstance.authentications['api-key'].apiKey = 'VOTRE_CLE_API';

const sendSmtpEmail = new Brevo.SendSmtpEmail();
sendSmtpEmail.to = [{email: 'client@example.com', name: 'Jean Dupont'}];
sendSmtpEmail.templateId = 1;
sendSmtpEmail.params = {PRENOM: 'Jean', COMMANDE: '#12345'};

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

Gérer les contacts via API

Ajouter un contact :

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

new_contact = sib_api_v3_sdk.CreateContact(
    email="nouveau@example.com",
    attributes={"PRENOM": "Marie", "COMPANY": "Acme"},
    list_ids=[2]  # ID de la liste dans Brevo
)

api_instance.create_contact(new_contact)

Mettre à jour un contact existant :

update_contact = sib_api_v3_sdk.UpdateContact(
    attributes={"COMMANDES": 5, "DERNIER_ACHAT": "2026-04-01"}
)
api_instance.update_contact("email@example.com", update_contact)

Déclencher une automation depuis l’API

L’API permet de déclencher une automation Brevo avec l’endpoint Track Events :

event_data = {
    "email": "client@example.com",
    "event": "COMMANDE_VALIDEE",
    "properties": {
        "id_commande": "12345",
        "montant": 89.90
    }
}
# POST https://in-automate.brevo.com/api/v1/trackEvent

Cela déclenche toute automation configurée sur cet événement dans Brevo.

Bonnes pratiques pour l’intégration

Rate limits : L’API Brevo est limitée à 400 requêtes/minute. Pour des envois en masse, utilisez l’endpoint d’envoi groupé (/emailCampaigns/sendNow) plutôt que des appels individuels.

Gestion des erreurs : L’API renvoie des codes HTTP standards. Implémentez un retry avec backoff exponentiel pour les erreurs 429 (rate limit) et 503 (service temporairement indisponible).

Templates vs contenu dynamique : Préférez les templates Brevo aux emails avec contenu HTML inline. Plus performant, plus maintenable, et les templates peuvent être modifiés sans redéployer.

Webhooks : Brevo peut vous notifier en temps réel des événements (email ouvert, cliqué, rebond). Configurez les webhooks dans Paramètres → Webhooks pour récupérer ces données dans votre application.

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 :

• N’importez que des contacts ayant donné un consentement explicite (RGPD)
• Nettoyez votre liste avant import : suppressions des doublons, correction des typos courantes (@gamil.com → @gmail.com)
• Segmentez dès l’import : créez des listes par source d’acquisition
• Historique d’engagement : si vous migrez depuis un autre outil, importez aussi le statut (actif/inactif)

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é :

• Position optimale : Pop-up avec délai 30 secondes OU exit intent
• Proposition de valeur claire : « Rejoignez 12 000 entrepreneurs et recevez… » vs « Inscrivez-vous à notre newsletter »
• Nombre de champs : 2 maximum (email + prénom) pour maximiser les conversions
• Double opt-in : Activez-le systématiquement pour rester en conformité RGPD et avoir une liste de qualité

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

Checklist avant envoi :

• [ ] Objet testé sur 2 variantes (A/B test)
• [ ] Prévisualisation mobile vérifiée
• [ ] Lien de désabonnement présent et fonctionnel
• [ ] Adresse physique de l’entreprise dans le pied de page
• [ ] Tous les liens testés et fonctionnels
• [ ] Texte alternatif sur toutes les images
• [ ] Envoi test à votre propre adresse validé

Paramétrage de l’envoi :

• Activez l’optimisation automatique de l’heure d’envoi si vous avez l’historique
• Configurez le suivi Google Analytics pour attribuer les conversions
• Activez les notifications de désabonnement pour votre équipe

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 :

• Consentement double opt-in intégré
• Gestion des désabonnements conforme (lien dans chaque email, pris en compte sous 10 jours)
• Registre des traitements exportable
• Demandes de suppression de données gérées automatiquement
• Hébergement EU uniquement (pas de transfert de données hors Europe)

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 :

• N’importez que des contacts ayant donné un consentement explicite (RGPD)
• Nettoyez votre liste avant import : suppressions des doublons, correction des typos courantes (@gamil.com → @gmail.com)
• Segmentez dès l’import : créez des listes par source d’acquisition
• Historique d’engagement : si vous migrez depuis un autre outil, importez aussi le statut (actif/inactif)

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é :

• Position optimale : Pop-up avec délai 30 secondes OU exit intent
• Proposition de valeur claire : « Rejoignez 12 000 entrepreneurs et recevez… » vs « Inscrivez-vous à notre newsletter »
• Nombre de champs : 2 maximum (email + prénom) pour maximiser les conversions
• Double opt-in : Activez-le systématiquement pour rester en conformité RGPD et avoir une liste de qualité

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

Checklist avant envoi :

• [ ] Objet testé sur 2 variantes (A/B test)
• [ ] Prévisualisation mobile vérifiée
• [ ] Lien de désabonnement présent et fonctionnel
• [ ] Adresse physique de l’entreprise dans le pied de page
• [ ] Tous les liens testés et fonctionnels
• [ ] Texte alternatif sur toutes les images
• [ ] Envoi test à votre propre adresse validé

Paramétrage de l’envoi :

• Activez l’optimisation automatique de l’heure d’envoi si vous avez l’historique
• Configurez le suivi Google Analytics pour attribuer les conversions
• Activez les notifications de désabonnement pour votre équipe

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 :

• N’importez que des contacts ayant donné un consentement explicite (RGPD)
• Nettoyez votre liste avant import : suppressions des doublons, correction des typos courantes (@gamil.com → @gmail.com)
• Segmentez dès l’import : créez des listes par source d’acquisition
• Historique d’engagement : si vous migrez depuis un autre outil, importez aussi le statut (actif/inactif)

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é :

• Position optimale : Pop-up avec délai 30 secondes OU exit intent
• Proposition de valeur claire : « Rejoignez 12 000 entrepreneurs et recevez… » vs « Inscrivez-vous à notre newsletter »
• Nombre de champs : 2 maximum (email + prénom) pour maximiser les conversions
• Double opt-in : Activez-le systématiquement pour rester en conformité RGPD et avoir une liste de qualité

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

Checklist avant envoi :

• [ ] Objet testé sur 2 variantes (A/B test)
• [ ] Prévisualisation mobile vérifiée
• [ ] Lien de désabonnement présent et fonctionnel
• [ ] Adresse physique de l’entreprise dans le pied de page
• [ ] Tous les liens testés et fonctionnels
• [ ] Texte alternatif sur toutes les images
• [ ] Envoi test à votre propre adresse validé

Paramétrage de l’envoi :

• Activez l’optimisation automatique de l’heure d’envoi si vous avez l’historique
• Configurez le suivi Google Analytics pour attribuer les conversions
• Activez les notifications de désabonnement pour votre équipe

A lire aussi

– Lire aussi
– Brevo reporting avancé
– Brevo API
– Lire aussi