Las claves API te permiten conectar de forma segura tu sitio web, aplicación u otra herramienta con tu cuenta de Brevo, para que puedas automatizar tareas como añadir contactos, enviar campañas o exportar datos. Tú decides exactamente a qué puede acceder cada clave.

Información relevante

• Solo el propietario de la cuenta o los usuarios con permiso de claves API pueden acceder a la página API Keys & MCP (Claves API y MCP), crear una nueva clave API o eliminar una existente. Para obtener más información sobre los permisos de usuario y los niveles de permiso, consulta nuestro artículo dedicado Añadir usuarios y asignar permisos en Brevo.
• Cada vez que se crea o elimina una clave API de la cuenta, el propietario de la cuenta recibirá una notificación por email, que incluye detalles como la dirección IP y la ubicación.
• Para ver todos los comandos que puedes utilizar con nuestra API, consulta nuestra documentación sobre API.

Crear una clave API

Al configurar una integración con tu cuenta de Brevo, es posible que necesites crear una nueva clave API y decidir a qué puedes acceder:

1. Haz clic en el menú desplegable de tu cuenta y selecciona Settings (Configuración) > SMTP & API (SMTP y API) > API Keys & MCP (Claves API y MCP).
2. Haz clic en Generate API key (Generar clave API).
   
3. Introduce el código de verificación enviado a tu dispositivo y haz clic en Verify (Verificar). Para obtener más información, consulta nuestro artículo dedicado Verificar la identidad para acciones sensibles en Brevo.
4. En Key name (Nombre de clave), asigna un nombre a tu clave API. Asegúrate de que el nombre especifique qué integración la utilizará para que puedas reconocerla fácilmente.

5. En Expiry (Caducidad), selecciona durante cuánto tiempo será válida la clave, desde 7 días hasta 1 año, o elige que no caduque.

   

   ❗️ Importante

   Incluso sin fecha de caducidad, una clave se desactiva si no se ha realizado ninguna llamada API correcta en los últimos 90 días. Recibirás un recordatorio por email 7 días antes y el día en que esto suceda. Si estableces una fecha de caducidad, también recibirás un recordatorio 3 días antes y el día en que caduque la clave.

6. En Access (Acceso), elige a qué parte de tu cuenta puede acceder la clave API:

   [Recomendado] Restringido Completo

   Con permisos Restricted (Restringidos), la clave solo puede acceder a los recursos que elijas.

   En Permissions (Permisos), selecciona None (Ninguno), Read (Lectura), Read/write (Lectura/escritura) o All (Todo) para cada recurso que necesite la clave. Para obtener más información, consulta nuestro artículo dedicado Acerca de los permisos de las claves API.

   

   Con permisos Full (Completos), la clave puede acceder a todos los recursos actuales y futuros, por lo que no hay que establecer ningún permiso.

   

7. Copia tu clave API y guárdala en un entorno seguro.
   

   ❗️ Importante

   Tu clave API solo está visible durante este paso. Una vez que se crea tu clave API, ya no podrás copiarla y tendrás que crear una nueva si la pierdes.
8. (Opcional) Para generar una versión de la clave API que te permita conectar un sistema de IA a Brevo a través del protocolo MCP:
   1. Activa Create MCP server API key (Crear clave API del servidor MCP). La clave API estándar se desactiva y, en su lugar, se genera una versión MCP de la clave API.
   2. Copia la clave API de MCP.
      
      Para obtener más información, consulta nuestro artículo dedicado ¿Qué es el protocolo de contexto del modelo (MCP)? 
9. Haz clic en I've saved my key (He guardado mi clave).

Cuando hayas terminado estos pasos, habrás creado correctamente una nueva clave API.

Ver las claves API

Para proteger tus claves API, las claves actuales no son visibles desde tu cuenta de Brevo. La página API Keys & MCP (Claves API y MCP) solo muestra los últimos dígitos de cada clave para que puedas distinguir varias claves:

La página también muestra la siguiente información para cada clave:

• Name (Nombre): el nombre de la clave y sus últimos dígitos. Las claves con una versión MCP muestran una etiqueta MCP. 

  💡 Información relevante

  Si ves un icono de advertencia junto al nombre de una clave, significa que la clave ha caducado.
• Permissions (Permisos): 
  • Full access (Acceso completo) significa que la clave puede acceder a todos los recursos. 
  • Restricted (Restringido) seguido de un número de alcances, significa que la clave solo puede acceder a ese número de recursos. Pasa el ratón sobre los permisos para ver qué recursos incluye la clave.
• Status (Estado): indica si la clave está activa o desactivada.
• Expires on (Caduca el): la fecha en la que caduca la clave, o No fixed date (Sin fecha fija) si no has establecido una fecha de caducidad.
• Last used on (Último uso el): la fecha de la última llamada API realizada con la clave.

Editar una clave API

Si una integración necesita más o menos acceso del que le concediste inicialmente, puedes cambiar el acceso de su clave API en cualquier momento. También puedes editar el nombre y la fecha de caducidad de la clave.

1. Haz clic en el menú desplegable de tu cuenta y selecciona Settings (Configuración) > SMTP & API (SMTP y API) > API Keys & MCP (Claves API y MCP).
2. Junto a la clave API que quieras editar, haz clic en el icono de tres puntos y selecciona Edit API key (Editar clave API).
   
3. Introduce el código de verificación enviado a tu dispositivo y haz clic en Verify (Verificar). Para obtener más información, consulta nuestro artículo dedicado Verificar la identidad para acciones sensibles en Brevo. 

4. Realiza los cambios necesarios. 

   ❗️ Importante

   Si eliminas un permiso que una integración aún necesita, sus llamadas API fallarán con el error Access denied for resource (Acceso denegado al recurso). Para obtener más información, consulta nuestro artículo dedicado Solución de problemas: problemas con las claves API
5. Haz clic en Save changes (Guardar cambios). 

Cuando hayas terminado estos pasos, habrás actualizado correctamente tu clave API.

Desactivar o reactivar una clave API

Si quieres hacer una pausa temporal en el uso de una clave API en vez de eliminarla por completo, puedes desactivarla y reactivarla más adelante cuando la necesites de nuevo. También puedes reactivar una clave que haya sido desactivada.

1. Haz clic en el menú desplegable de tu cuenta y selecciona Settings (Configuración) > SMTP & API (SMTP y API) > API Keys & MCP (Claves API y MCP).
2. Junto a la clave API que quieras desactivar o reactivar, haz clic en el icono de tres puntos y selecciona Deactivate API key (Desactivar clave API) o Activate API key (Activar clave API).
   

Cuando hayas terminado estos pasos, habrás desactivado o reactivado correctamente tu clave API.

Eliminar una clave API

Si tu cuenta ha sufrido un ataque o si ya no utilizas una integración que requiera una clave API concreta, puedes eliminar dicha clave API:

1. Haz clic en el menú desplegable de tu cuenta y selecciona Settings (Configuración) > SMTP & API (SMTP y API) > API Keys & MCP (Claves API y MCP).
2. Junto a la clave API que quieras eliminar, haz clic en el icono de tres puntos y selecciona Delete API key (Eliminar clave API).
   

Cuando hayas terminado estos pasos, habrás eliminado correctamente tu clave API.

Prácticas recomendadas para las claves API

Protege todas las claves API de la misma manera que protegerías una contraseña. A continuación te indicamos algunas prácticas recomendadas que debes tener en cuenta:

• Utiliza una clave API diferente para cada integración y especifica el nombre de esta en el nombre de la clave. De esta forma, si una clave se ve comprometida, podrás eliminarla sin que el resto de tus integraciones se vean afectadas.
• Utiliza el acceso Restricted (Restringido) y otorga a cada clave solo los permisos que necesite. De este modo, una clave comprometida solo podrá acceder a los recursos que hayas seleccionado.
• Guarda las claves API en un entorno seguro, no en un documento de Word ni en una nota adhesiva.
• No expongas tu clave API al público. Oculta tu clave API o, mejor aún, tápala por completo en capturas de pantalla o vídeos.
• Nunca envíes una clave API por email, ya que esto daría acceso a tu cuenta de Brevo si alguien pirateara tu cuenta de email.
• Elimina siempre las claves API que ya no se utilicen para limitar los riesgos de filtraciones.
• Active el bloqueo de direcciones IP para que las llamadas API de direcciones IP no reconocidas se bloqueen hasta que las autorices. Para obtener más información, consulta nuestro artículo dedicado Autorizar y bloquear direcciones IP para la seguridad de las API y el SMTP.

⏭️ ¿Qué es lo siguiente?

• Acerca de los permisos de las claves API 
• Solución de problemas: problemas con las claves API
• Crear y administrar claves SMTP
• Autorizar y bloquear direcciones IP para la seguridad de las API y el SMTP
• Mi cuenta se ha visto comprometida, ¿qué debo hacer?
• ¿Qué es el protocolo de contexto del modelo (MCP)?

🤔 ¿Tiene alguna duda?

Si tiene alguna pregunta, no dude en ponerse en contacto con nuestro equipo de asistencia mediante la creación de un ticket desde su cuenta. Si todavía no tiene una cuenta, puede ponerse en contacto con nosotros aquí.

Si necesitas ayuda con un proyecto usando Brevo, podemos ponerte en contacto con la agencia partner de Brevo adecuada.