Objetivo de aprendizaje
Al final de esta guía, sabrás cómo generar una clave de API de lemlist, copiarla y guardarla de forma segura, y gestionar varias claves de API (cambiarles el nombre, consultar su uso, eliminarlas).
¿Por qué es importante?
Las claves de API te permiten conectar lemlist con herramientas externas como Clay, Zapier, apps personalizadas o sistemas internos. Sin una clave de API:
No puedes integrar lemlist con plataformas de terceros
Los flujos de trabajo de automatización no funcionan
Solo puedes introducir los datos manualmente
Generar una clave de API te da acceso a:
✅ Flujos de trabajo automatizados (añadir Leads, activar campañas, sincronizar datos)
✅ Integraciones personalizadas con tus herramientas tecnológicas
✅ Acceso programático a las funciones de lemlist
Requisitos previos
Antes de generar una clave de API:
Tienes una cuenta de lemlist con acceso a Settings
Sabes qué herramienta o app necesita la clave de API (Clay, Zapier, integración personalizada)
Tienes un lugar seguro donde guardar la clave (se recomienda un gestor de contraseñas)
Paso 1: Abre Integrations (configuración de la API)
Haz clic en tu icono de perfil (esquina inferior izquierda) y selecciona Settings
En Settings, ve a Integrations y haz clic en Generate
Paso 2: Asigna un nombre y crea tu clave de API
Asigna a tu clave de API un nombre descriptivo que indique para qué sirve.
Ejemplos:
Clay IntegrationZapier AutomationCustom CRM Sync
Introduce el nombre y haz clic en Create Key
Paso 3: Copia y guarda tu clave de API de forma segura
⚠️ Crítico: solo puedes ver la clave de API una vez después de generarla. Si la pierdes, tendrás que generar una nueva.
Copia la clave de API y pégala en:
Un gestor de contraseñas (1Password, LastPass, Bitwarden)
Un documento seguro
La herramienta de integración que la necesita (Clay, Zapier, etc.)
💡 Nunca compartas tu clave de API públicamente (no la pegues en Slack, en un email ni en GitHub).
Paso 4: Gestiona tus claves de API
Una vez generadas, puedes gestionar tus claves de API en la sección API keys dentro de Integrations. Si la lista está replegada, haz clic en la flecha para desplegarla
Consulta la última vez que se usó
La columna Last used muestra cuándo se usó por última vez cada clave de API
Úsala para identificar las claves sin usar o inactivas.
Cambiar el nombre de una clave de API
Haz clic en el icono de edición (✏️) junto a la clave de API
Introduce un nombre nuevo
Guarda
Eliminar una clave de API
Si ya no necesitas una clave de API:
Haz clic en el icono de eliminar (🗑️) junto a la clave
Confirma la eliminación
⚠️ Al eliminar una clave de API, se revoca inmediatamente el acceso de todas las integraciones que la usan. Antes de eliminarla, asegúrate de que la clave no esté en uso.
¿Cómo saber que ha funcionado?
✓ La clave de API aparece en la sección API keys con el nombre que le asignaste
✓ Copiaste correctamente la clave de API y la guardaste de forma segura
✓ La herramienta de integración (Clay, Zapier, etc.) se conecta con la clave de API
✓ El valor de Last Used se actualiza cuando la clave está en uso
Para probarlo, pega la clave de API en la herramienta de integración y comprueba que la conexión se realiza correctamente.
Solución de problemas
Causas habituales del error "No API Key Provided"
Uso incorrecto de los headers: la clave de API no está incluida en los headers de la solicitud esperados.
Método de autenticación inadecuado: se usa un método de autenticación incorrecto, como poner la clave de API en el body JSON o usar un header no compatible.
Clave de API no generada o mal configurada: la clave de API no se ha creado o no se ha copiado correctamente.
Limitaciones de la cuenta: es posible que tu tipo de cuenta no admita integraciones por API.
Problema: no encuentras la sección de la API
Causa: es posible que no tengas los permisos adecuados o que la sección de la API esté oculta.
Solución:
Asegúrate de haber iniciado sesión como admin o de tener permisos de acceso a la API
Si no ves la sección de la API, contacta con el admin de tu espacio de trabajo
Problema: la clave de API no funciona en la integración
Causa: la clave de API se copió mal, ha expirado o se ha revocado.
Solución:
Comprueba que copiaste la clave completa (sin espacios ni caracteres de más)
Comprueba si la clave de API se eliminó o se volvió a generar
Genera una nueva clave de API y actualiza la integración
Asegúrate de que la clave de API esté incluida en los headers con el formato correcto (p. ej., 'Authorization: Bearer YOUR_API_KEY').
Si usas HTTP Basic Authentication, sigue las indicaciones sobre el nombre de usuario y la contraseña.
Problema: perdiste la clave de API antes de copiarla
Causa: las claves de API solo se pueden ver una vez, al generarlas.
Solución:
Elimina la clave de API perdida
Genera una nueva clave de API
Cópiala y guárdala de inmediato en un gestor de contraseñas
Problema: la clave de API muestra "Never Used", pero la integración funciona
Causa: el valor de Last Used puede tardar unos minutos en actualizarse.
Solución:
Espera 5–10 minutos y actualiza la página
Si después de 24 horas sigue mostrando "Never Used", comprueba que la integración usa la clave correcta
Consejos de optimización
Usa nombres descriptivos: nombra las claves de API según su finalidad (p. ej., "Clay Integration", "Zapier Workflow") para identificarlas fácilmente más adelante.
Guárdalas en un gestor de contraseñas: usa 1Password, LastPass o Bitwarden para guardar las claves de API de forma segura, con notas sobre dónde se usan.
Genera una clave distinta para cada integración: no reutilices la misma clave de API en varias herramientas. Así es más fácil revocar el acceso sin afectar a otras integraciones.
Audita las claves cada trimestre: revisa tus claves de API cada 3 meses. Elimina las claves sin usar o inactivas para reducir los riesgos de seguridad.
Rota las claves periódicamente: por seguridad, vuelve a generar las claves de API cada 6–12 meses, sobre todo en las integraciones críticas.
Documenta el uso de las claves: anota qué clave de API se usa en cada sitio (p. ej., "Clay Integration key used in Clay table XYZ").
Supervisa el valor de Last Used: consulta Last Used con regularidad para identificar las claves que puedan estar comprometidas o que ya no necesites.
Documentación avanzada de la API
Configurar correctamente la autenticación de la API: asegúrate de que tu clave de API esté incluida en el header de la solicitud y siga los estándares de autenticación de lemlist. Hay dos métodos posibles:
Método 1: Bearer token en el header Authorization
Usa este método cuando se indique la autenticación con Bearer token. El header de la solicitud debe incluir:
Authorization: Bearer YOUR_API_KEY
Notas importantes:
No uses otros headers personalizados como
Api-Keyox-api-key.No incluyas la clave de API en los parámetros de consulta ni en el body JSON.
Método 2: HTTP Basic Authentication
En algunos endpoints, lemlist requiere la autenticación HTTP Basic con un nombre de usuario vacío y la clave de API como contraseña. Ejemplo:
Comando Curl:
curl -X POST \ -H "Content-Type: application/json" \ -u ":YOUR_API_KEY" \ "https://api.lemlist.com/campaigns/{CAMPAIGN_ID}/leads" \ -d '{"email":"[email protected]"}'Código Python:
import requests response = requests.post( "https://api.lemlist.com/campaigns/{CAMPAIGN_ID}/leads", auth=("", "YOUR_API_KEY"), headers={"Content-Type":"application/json"}, json={"email":"[email protected]"} )
Para ver todas las funciones de la API (endpoints, parámetros, ejemplos), visita:
Qué encontrarás:
Referencia completa de la API (añadir Leads, crear campañas, obtener estadísticas, etc.)
Ejemplos de código en varios lenguajes (JavaScript, Python, cURL)
Detalles de la autenticación
Límites de frecuencia y buenas prácticas