Dans cet article, nous vous expliquons ce qu'est une clé API et comment vous pouvez en créer une nouvelle ou en supprimer une ancienne.

Bon à savoir

Seuls les utilisateurs Brevo ayant une autorisation pour les clés API ont accès à la page Clés API et MCP pour créer une nouvelle clé API ou supprimer une clé API existante.

➡️ Pour en savoir plus sur les autorisations et les niveaux d'autorisation des utilisateurs, consultez notre article dédié Autorisations des utilisateurs et niveaux d'autorisation dans Brevo.

Qu'est-ce qu'un clé API ?

Une clé API est un code utilisé pour identifier et authentifier une application ou un utilisateur. Elle fait office d'identifiant unique et fournit un jeton secret à des fins d'authentification.

Par exemple, vous pouvez utiliser une clé API pour connecter votre site web ou votre système d'information à Brevo. Vous pourrez ainsi déclencher certaines actions automatiquement ou manuellement entre les deux.

Avec une clé API, vous pouvez aussi vous connecter à notre API pour ajouter automatiquement de nouveaux contacts, ou même effectuer des tâches plus complexes, comme par exemple :

• Créer et planifier des campagnes depuis l'API.
• Exporter des utilisateurs inclus sur des listes spécifiques.
• Exporter des campagnes de statistiques, etc..

Pour accéder à la liste complète des commandes mises à votre disposition avec notre API, consultez la documentation de notre API.

Où puis-je trouver mes clés API ?

Pour protéger vos clés API et les rendre plus sûres, vos clés API existantes ne sont pas visibles depuis votre compte Brevo. Seuls les derniers chiffres des clés sont affichés sur la page Clés API et MCP afin que vous puissiez faire la différence entre plusieurs clés si nécessaire :

C'est pourquoi nous vous conseillons vivement de stocker votre clé API dans un environnement sûr lorsque vous la créez. Si vous avez perdu votre clé API, nous vous recommandons d'en créer une nouvelle, de la conserver dans un environnement sûr et de remplacer la précédente.

Créer une clé API

Lorsque vous configurez une intégration avec votre compte Brevo, vous aurez peut-être besoin de créer une nouvelle clé API :

1. Click your account dropdown and select Settings > SMTP & API > API Keys & MCP.
2. Click Generate a new API key.
   
3. Name your API key. Make sure it specifies with which integration the API key will be used so that you can easily recognize it.
4. Click Generate.
   
5. Copiez votre clé API et conservez-la dans un environnement sûr.
   
   ❗️ Important

   Your API key is only visible during this step. Once your API key is created, you won't be able to copy it anymore and you'll need to create a new one if you lose it.
   
6. (Optional) Activate the Create MCP server API key option to generate a version of the API key allowing you to connect an AI system to Brevo via the MCP protocol. To learn more, check our dedicated article What is Model Context Protocol (MCP)?.
   💡 Bon à savoir

   If you activate the Create MCP server API key, the API key created in step 4 is deactivated and a MCP version of the API key is generated instead.
7. Cliquez sur OK.

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

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

1. Cliquez sur le menu déroulant du compte et sélectionnez Paramètres > SMTP & API > clé API & MCP.
2. Sélectionnez la clé API que vous souhaitez désactiver.
3. Cliquez sur Désactiver la clé API.
   

Vous avez maintenant désactivé votre clé API.

To reactivate a key, select it again and click Activate API key.

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é API & MCP.
2. Sélectionnez la clé API que vous souhaitez supprimer.
3. Cliquez sur Supprimer la clé API.

Vous avez bien supprimé votre clé API.

Les bonnes pratiques avec les clés API

Les clés API offrent un accès complet à votre compte Brevo et doivent être aussi bien protégées qu'un mot de passe. Voici quelques bonnes pratiques à garder à l'esprit lorsque vous utilisez des clés API :

• Utilisez une clé API différente pour chaque intégration et indiquez le nom de l'intégration dans le nom de la clé API afin de savoir exactement quelle clé correspond à chaque intégration. Ainsi, si une clé API est compromise, vous pouvez la supprimer sans perturber vos autres intégrations.
• Conservez vos clés API dans un environnement sûr, et non dans un document Word ou sur un post-it.
• Ne rendez pas votre clé API visible au public. Assurez-vous de cacher votre clé API, ou mieux encore, de l'effacer complètement dans vos impressions écran ou vos captations en vidéo.
• N'envoyez jamais une clé API par email, car toute personne piratant votre boîte email pourrait accéder à votre compte Brevo.
• Vous devez toujours supprimer les clés API qui ne sont plus utilisées afin de limiter les risques de fuite.

🤔 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.