Las claves API le permiten conectar de forma segura su sitio web, aplicación u otra herramienta a su cuenta de Brevo para que pueda automatizar tareas como añadir contactos, enviar campañas o exportar datos.

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, consulte 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.

¿Qué es una clave API?

Una clave API es un código utilizado para identificar y autenticar una aplicación o un usuario. Funciona como un identificador único y proporciona un token secreto para permitir la autenticación. Por ejemplo, puede utilizar una clave API para conectar su sitio web o sistema de información a Brevo. Esto le permitirá activar de forma automática y manual determinadas acciones entre ambos.

Con una clave API, también puede conectarse a nuestra API para añadir automáticamente nuevos contactos, así como realizar tareas más complejas, como:

• Crear y programar campañas desde la API.
• Exportar usuarios que estén en determinadas listas.
• Exportar estadísticas de las campañas, etc.

Para acceder a la lista completa de comandos que puede utilizar con nuestra API, consulte nuestra documentación sobre API.

¿Dónde puedo encontrar mis claves API?

Sus claves API actuales no se pueden ver desde su cuenta de Brevo para protegerlas y hacerlas más seguras. En la página API Keys & MCP (Claves API y MCP), solo aparecen los últimos dígitos de las claves para que pueda distinguir unas de otras, si es necesario:

Por ello, le recomendamos encarecidamente que cuando cree su clave API, la guarde en un entorno seguro. Si ha perdido su clave API, le recomendamos que cree una nueva, la guarde en un entorno seguro y sustituya la anterior.

Crear una clave API

Al configurar una integración con su cuenta de Brevo, es posible que necesite crear una nueva clave API:

1. Haga clic en el menú desplegable de su cuenta y seleccione Settings (Configuración) > SMTP y API > API Keys & MCP (Claves API y MCP).
2. Haga clic en Generate a new API key (Generar una nueva clave API).
   
3. Introduzca el código de verificación de 6 dígitos enviado al email de su cuenta y, a continuación, haga clic en Verify (Verificar).
   💡 Información relevante

   Si no recibe el código, puede volver a solicitarlo por email o SMS transcurrido 1 minuto.
4. Asigne un nombre a su clave API. Asegúrese de que especifica con qué integración se utilizará la clave API para que pueda reconocerla fácilmente.
5. Configure una fecha de caducidad de 7 días a 1 año o elija que la clave API no caduque.
   ❗️ Importante

   Elegir No expiration (Sin caducidad) solo significa que la clave no tiene una fecha de caducidad fija. Esto no la exime de la política de inactividad independiente de Brevo:

   • Fecha de caducidad alcanzada: recibirá un recordatorio por email 3 días antes y el día en que caduque la clave.
   • 90 días de inactividad: aunque no se haya configurado ninguna fecha de caducidad, la clave se desactivará si no se ha realizado ninguna llamada API correcta en los últimos 90 días. Recibirá un recordatorio por email 7 días antes y el día en que esto suceda.
6. Haga clic en Generate (Generar).
   
7. Copie su clave API y guárdela en un entorno seguro.
   
   ❗️ Importante

   Su clave API solo está visible durante este paso. Una vez que se crea su clave API, ya no podrá copiarla y tendrá que crear una nueva si la pierde.
   
8. (Opcional) Active la opción Create MCP server API key (Crear clave API del servidor MCP) para generar una versión de la clave API que le permita conectar un sistema de IA a Brevo a través del protocolo MCP. Para obtener más información, consulte nuestro artículo dedicado ¿Qué es el protocolo de contexto del modelo (MCP)?.
   💡 Información relevante

   Si activa la opción Create MCP server API key (Crear clave API del servidor MCP), la clave API creada en la etapa 4 se desactiva y se genera en su lugar una versión MCP de la clave API.
9. Haga clic en OK (Aceptar).

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

Desactivar una clave API

Si desea hacer una pausa temporal en el uso de una clave API en vez de eliminarla por completo, puede desactivarla:

1. Haga clic en el menú desplegable de su cuenta y seleccione Settings (Configuración) > SMTP y API > API Keys & MCP (Claves API y MCP).
2. Seleccione la clave API que desea eliminar.
3. Haga clic en Deactivate API key (Desactivar clave API).
   

Ha desactivado correctamente su clave API.

Para reactivar una clave, selecciónela de nuevo y haga clic en Activate clave API (Activar clave API).

Eliminación de una clave de API

Si su cuenta ha sufrido un ataque o si ya no utiliza una integración que necesita una clave API concreta, puede eliminar esa clave API:

1. Haga clic en el menú desplegable de su cuenta y seleccione Settings (Configuración) > SMTP y API > API Keys & MCP (Claves API y MCP).
2. Seleccione la clave API que desea eliminar.
3. Haga clic en Delete API key (Eliminar clave API).

Cuando haya completado estos pasos, habrá eliminado correctamente su clave API.

Prácticas recomendadas para claves API

Las claves API otorgan acceso completo a su cuenta de Brevo y deben protegerse de la misma forma que una contraseña. A continuación, le indicamos algunas prácticas recomendadas que debe tener en cuenta cuando trabaje con claves API:

• Utilice una clave API diferente para cada integración y especifique el nombre de esta en el nombre de la clave API para que pueda saber exactamente qué clave corresponde a cada integración. De esta forma, si una clave API se ve comprometida, podrá eliminarla sin que el resto de sus integraciones se vean afectadas.
• Guarde las claves API en un entorno seguro, no en un documento de Word ni en una nota adhesiva.
• No exponga su clave API al público. Asegúrese de ocultar su clave API o incluso de realizar capturas de pantalla o vídeos de ella.
• Nunca envíe una clave API por email, ya que esto daría acceso a su cuenta de Brevo si alguien pirateara su cuenta de email.
• Elimine siempre las claves API que ya no se utilicen para limitar los riesgos de filtraciones.
• Mantenga sus claves activas en uso realizando al menos una llamada API correcta cada 90 días, incluso si no se ha configurado ninguna fecha de caducidad, para evitar una desactivación inesperada. 
• Active el bloqueo de direcciones IP para que las llamadas API de direcciones IP no reconocidas se bloqueen hasta que las autorice. Para obtener más información, consulte nuestro artículo dedicado Autorizar y bloquear direcciones IP para la seguridad de las API y el SMTP.

Solucionar problemas con las claves API

Si tiene problemas con sus claves API, revise los siguientes consejos para la solución de problemas antes de ponerse en contacto con nuestro equipo de asistencia.

Mi clave API muestra "Caduca: nunca", pero he recibido una advertencia de inactividad

No ha seleccionado ninguna fecha de caducidad al crear su clave API, pero aun así ha recibido un email avisándole de que la clave se desactivará por inactividad.

Causas y soluciones comunes

Comprobar la solución

Realice una llamada API de prueba con la clave y, a continuación, compruebe en la página API Keys & MCP (Claves API y MCP) que su estado aparece como activo.

Si el problema persiste, póngase en contacto con nuestro equipo de asistencia e incluya los últimos dígitos de la clave y el mensaje de advertencia exacto que ha recibido.

He recibido un email de seguridad con el asunto "Verificar una nueva IP"

Ha recibido un email de Brevo en el que se le pide que confirme o rechace una llamada API realizada desde una dirección IP no reconocida, y no está seguro de si es legítima o de qué hacer a continuación.

Causas y soluciones comunes

Comprobar la solución

Vaya a la página Authorized IPs (IP autorizadas) y compruebe que la dirección IP muestra el estado que espera (autorizada o eliminada).

Si sigue recibiendo alertas sobre direcciones IP que no reconoce después de cambiar su clave API, póngase en contacto con nuestro equipo de asistencia.

⏭️ ¿Qué es lo siguiente?

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