Créer votre clé API Brevo : accès SMTP et contacts

Étape 1 : Accéder aux paramètres API Brevo

Naviguer vers la section SMTP et API

1. Connectez-vous à votre compte Brevo sur app.brevo.com
2. Cliquez sur votre nom de compte ou votre avatar en haut à droite
3. Sélectionnez Paramètres dans le menu déroulant puis SMTP et API dans le menu de gauche
4. Cliquez sur l’onglet Clés API et MCP

Vous voyez la liste de vos clés existantes et le bouton pour en créer une nouvelle.

---

Étape 2 : Créer la clé API

Nommer la clé

1. Cliquez sur Générer une nouvelle clé API
2. Saisissez un nom descriptif qui identifie l’usage et l’environnement :
   • Connecteur-LogicielSurMesure-Production
   • Sync-Contacts-Staging
   • Import-Initial
3. Copier la clé immédiatement : Brevo affiche la valeur de la clé une seule fois lors de la génération Copiez-la immédiatement dans un gestionnaire de secrets. La clé ressemble à :

xkeysib-a1b2c3d4e5f6...

Si vous fermez cette fenêtre sans avoir copié la clé, elle ne sera plus affichable. Il faudra en créer une nouvelle et mettre à jour votre configuration.

4. Cliquez sur OK

Un bon nommage est essentiel pour identifier rapidement quelle clé appartient à quel connecteur et pouvoir la révoquer précisément en cas de problème.

---

Étape 3 : Sécuriser et transmettre la clé API

Stockage en variable d’environnement

La clé API ne doit jamais être écrite dans le code source ou versionnée dans git. Stockez-la en variable d’environnement dans votre logiciel :

# .env.local (ajouté dans .gitignore, jamais versionné)
BREVO_API_KEY=xkeysib-votre-cle-api-brevo

Utilisation dans le code Symfony avec le bundle getbrevo/brevo-php :

// Configuration du client Brevo
public function __construct(
    #[Autowire(env: 'BREVO_API_KEY')] string $apiKey
) {
    $this->client = new \Brevo\Brevo(apiKey: $apiKey);
}

Format du header d’authentification

Pour les appels API REST directs (sans SDK), le header d’authentification Brevo est :

curl -X GET https://api.brevo.com/v3/contacts \
  -H "api-key: xkeysib-votre-cle-api-brevo" \
  -H "accept: application/json"

Attention : contrairement à d’autres API (comme Attio ou HubSpot), Brevo utilise le header api-key (pas Authorization: Bearer).

Transmission à SmartBooster

Pour transmettre la clé API à l’équipe SmartBooster lors de l’intégration :

• Utiliser un gestionnaire de mots de passe partagé (Bitwarden, 1Password, Dashlane)
• Ne jamais envoyer par email, SMS ou messagerie en clair (Slack, Teams, WhatsApp)
• Créer une note sécurisée avec : la clé API, le compte Brevo concerné et l’environnement (développement, staging, production)

---

Vérifier l’accès

Avant de lancer les tests d’intégration, vérifiez que la clé fonctionne avec un appel de test :

curl -X GET https://api.brevo.com/v3/account \
  -H "api-key: VOTRE_CLE_API"

La réponse doit retourner les informations de votre compte (email, plan, crédits restants). Une erreur 401 indique que la clé est incorrecte ou révoquée.

---

Accès SMTP Brevo (si nécessaire)

Si votre logiciel utilise le SMTP Brevo plutôt que l’API REST (via Symfony Mailer, PHPMailer ou une bibliothèque SMTP standard), les identifiants SMTP sont différents de la clé API.

Récupérer les identifiants SMTP

1. Dans SMTP et API, restez sur l’onglet SMTP
2. Les identifiants sont :
   • Serveur SMTP : smtp-relay.brevo.com
   • Port : 587 (TLS) ou 465 (SSL)
   • Login : votre adresse email Brevo
   • Mot de passe : la clé SMTP affichée dans cet écran (différente de la clé API)

Configuration dans Symfony Mailer

# config/packages/mailer.yaml
framework:
  mailer:
    dsn: 'smtp://LOGIN:MOT_DE_PASSE_SMTP@smtp-relay.brevo.com:587'

Bonne pratique : utiliser l’API REST pour les envois transactionnels depuis un connecteur métier (meilleure gestion des erreurs, webhooks de statut). Le SMTP est adapté pour les bibliothèques qui ne supportent pas nativement l’API Brevo.

---

Références

• Documentation API Brevo
• Brevo - Authentification API
• Brevo SDK PHP officiel