Les clés API vous permettent de connecter en toute sécurité votre site web, votre application ou un autre outil à votre compte Brevo, afin d’automatiser des tâches telles que l’ajout de contacts, l’envoi de campagnes ou l’exportation de données. Vous décidez exactement à quoi chaque clé peut accéder.

Bon à savoir

• Seuls les utilisateurs ou le propriétaire du compte ayant une autorisation de clés API peuvent accéder à la page Clés API & MCP, créer une nouvelle clé API ou supprimer une clé API existante. Pour en savoir plus sur les autorisations utilisateurs et les niveaux d'autorisation, consultez notre article dédié Ajouter des utilisateurs et attribuer des autorisations dans Brevo.
• Chaque fois qu’une clé API est créée ou supprimée du compte, le compte propriétaire recevra une notification par email, comprenant des informations telles que l’adresse IP et la localisation.
• Pour consulter toutes les commandes que vous pouvez utiliser avec notre API, consultez la documentation de notre API.

Créer une clé API

Lorsque vous configurez une intégration avec votre compte Brevo, vous devrez peut-être créer une nouvelle clé API et décider à quoi elle donne accès :

1. Cliquez sur le menu déroulant du compte et sélectionnez Paramètres > SMTP & API > clés API & MCP.
2. Cliquez sur Générer une clé API.
   
3. Entrez le code de vérification envoyé sur votre appareil et cliquez sur Vérifier. Pour en savoir plus, consultez notre article dédié Vérifier votre identité pour les actions sensibles dans Brevo.
4. Dans Nom de la clé, donnez un nom à votre clé API. Faites bien attention à ce que le nom précise dans quelle intégration elle sera utilisée afin de la reconnaître facilement.

5. Dans Expiration, sélectionnez la durée de validité de la clé, de 7 jours à 1 an, ou choisissez l'option sans expiration.

   

   ❗️ Important

   Même si aucune date d’expiration n’est définie, une clé est désactivée si elle n’a effectué aucun appel API réussi durant 90 jours. Vous recevrez un email de rappel 7 jours avant et le jour où cela se produira. Si vous définissez une date d’expiration, vous recevrez également un rappel 3 jours avant et le jour de l’expiration de la clé.

6. Dans Accès, choisissez les parties de votre compte auxquelles la clé API peut accéder :

   [Recommandé] Restreint Complet

   Avec les autorisations Restreintes, la clé peut uniquement accéder aux ressources que vous choisissez.

   Sous Autorisations, sélectionnez Aucune, Lecture, Lecture/Écriture ou Toutes pour chaque ressource dont la clé a besoin. Pour en savoir plus, consultez notre article dédié À propos des autorisations des clés API.

   

   Avec des autorisations Complètes, la clé peut accéder à toutes les ressources actuelles et futures ; il n'y a donc aucune autorisation à définir.

   

7. Copiez votre clé API et conservez-la dans un environnement sûr.
   

   ❗️ Important

   Votre clé API est uniquement visible pendant cette étape. Une fois votre clé API créée, vous ne pourrez plus la copier et vous devrez en créer une nouvelle si vous la perdez.
8. (Facultatif) Pour générer une version de la clé API vous permettant de connecter un système d’IA à Brevo via le protocole MCP :
   1. Activez Créer une clé API de serveur MCP. La clé API standard est désactivée et une version MCP de la clé API est générée à la place.
   2. Copiez la clé API MCP.
      
      Pour en savoir plus, consultez notre article dédié Qu'est-ce que le Model Context Protocol (MCP) ?. 
9. Cliquez sur J'ai enregistré ma clé.

Vous avez bien créé une nouvelle clé API.

Voir vos clés API publique

Pour protéger vos clés API, les clés existantes ne sont pas visibles depuis votre compte Brevo. La page Clés API et MCP n'affiche que les derniers chiffres de chaque clé afin que vous puissiez faire la différence entre plusieurs clés :

La page affiche également les informations suivantes pour chaque clé :

• Nom : le nom de la clé et ses derniers chiffres. Les clés dotées d’une version MCP affichent un libellé MCP. 

  💡 Bon à savoir

  Si vous voyez une icône d'avertissement à côté d'une balise RSS, cela signifie que la clé a expiré.
• Autorisations : 
  • Accès complet signifie que la clé peut accéder à toutes les ressources. 
  • Restreint suivi d’un nombre de portées signifie que la clé ne peut accéder qu’à ce nombre de ressources. Survolez les autorisations pour voir les ressources incluses dans la clé.
• Statut : indique si la clé est active ou désactivée.
• Expire le : la date à laquelle la clé expire, ou Aucune date fixe si vous n’avez pas défini de date d’expiration.
• Dernière utilisation le : la date du dernier appel API effectué avec cette clé.

Modifier une clé API

Si une intégration nécessite plus ou moins d'accès que vous ne lui en avez donné initialement, vous pouvez modifier les accès de sa clé API à tout moment. Vous pouvez aussi modifier le nom et la date d'expiration de la clé.

1. Cliquez sur le menu déroulant du compte et sélectionnez Paramètres > SMTP & API > clés API & MCP.
2. À côté de la clé API que vous souhaitez modifier, cliquez sur l’icône à trois points et sélectionnez Modifier la clé API.
   
3. Entrez le code de vérification envoyé sur votre appareil et cliquez sur Vérifier. Pour en savoir plus, consultez notre article dédié Vérifier votre identité pour les actions sensibles dans Brevo. 

4. Apportez les modifications nécessaires. 

   ❗️ Important

   Si vous supprimez une autorisation dont une intégration a encore besoin, ses appels API échoueront avec une erreur Accès refusé pour la ressource. Pour en savoir plus, consultez notre article dédié Résoudre les problèmes - Problèmes avec les clés API
5. Cliquez sur Enregistrer les modifications. 

Vous avez bien mis à jour votre clé API.

Désactiver ou réactiver une clé API

Si vous souhaitez suspendre temporairement l’utilisation d’une clé API au lieu de la supprimer complètement, vous pouvez la désactiver et la réactiver plus tard lorsque vous en aurez à nouveau besoin. Vous pouvez également réactiver une clé qui a été désactivée.

1. Cliquez sur le menu déroulant du compte et sélectionnez Paramètres > SMTP & API > clés API & MCP.
2. À côté de la clé API que vous souhaitez désactiver ou réactiver, cliquez sur l’icône à trois points et sélectionnez Désactiver la clé API ou Activer la clé API.
   

Vous avez maintenant désactivé ou réactivé votre clé API.

Supprimer une clé API

Si votre compte est compromis ou si vous n'utilisez plus une intégration qui nécessite d'utiliser une clé API particulière, vous pouvez supprimer cette clé API :

1. Cliquez sur le menu déroulant du compte et sélectionnez Paramètres > SMTP & API > clés API & MCP.
2. À côté de la clé API que vous souhaitez supprimer, cliquez sur l’icône des trois points et sélectionnez Supprimer la clé API.
   

Vous avez bien supprimé votre clé API.

Meilleures pratiques concernant les clés API

Protégez chaque clé API de la même manière qu’un mot de passe. Voici quelques bonnes pratiques à garder en tête :

• Utilisez une clé API différente pour chaque intégration et indiquez le nom de l'intégration dans le nom de la clé. Ainsi, si une clé est compromise, vous pouvez la supprimer sans affecter vos autres intégrations.
• Utilisez l’accès restreint et ne donnez à chaque clé que les autorisations dont elle a besoin. De cette façon, une clé compromise ne peut accéder qu’aux ressources que vous avez sélectionnées.
• Conservez vos clés API dans un environnement sûr, et non dans un document Word ou sur un post-it.
• N'exposez pas votre clé API au public. Cachez votre clé API ou, mieux encore, supprimez-la complètement dans les captures d'écran ou les vidéos.
• N'envoyez jamais une clé API par email car cela donnerait accès à votre compte Brevo si quelqu'un piratait votre compte email.
• Vous devez toujours supprimer les clés API qui ne sont plus utilisées afin de limiter les risques de fuite.
• Activez le blocage des adresses IP pour que les appels API provenant d’adresses IP non reconnues soient bloqués jusqu’à ce que vous les autorisiez. Pour en savoir plus, consultez notre article dédié Autoriser et bloquer des adresses IP pour la sécurité de l’API et du SMTP.

⏭️ Et après ?

• À propos des autorisations de clés API 
• Résoudre les problèmes - Problèmes liés aux clés API
• Créer et gérer vos clés SMTP
• Autoriser et bloquer les adresses IP pour la sécurité des API et SMTP
• Mon compte a été compromis, que dois-je faire ?
• Qu'est-ce que le Model Context Protocol (MCP) ?

🤔 Vous avez des questions ?

Pour toute question, n’hésitez pas à contacter notre service client en créant un ticket à partir de votre compte. Si vous n’avez pas encore de compte, vous pouvez nous contacter ici.

Si vous avez besoin d'aide pour un projet impliquant Brevo, nous pouvons vous mettre en relation avec une agence partenaire Brevo.