Ce que vous allez apprendre
Ce guide vous montre comment générer une clé API lemlist, la copier et la conserver en lieu sûr. Vous apprendrez aussi à gérer plusieurs clés API : les renommer, vérifier leur utilisation et les supprimer.
Pourquoi c’est important
Les clés API vous permettent de connecter lemlist à des outils externes (Clay, Zapier, applications sur mesure ou systèmes internes). Sans clé API :
Vous ne pouvez pas connecter lemlist à des plateformes tierces.
Vos scénarios d’automatisation ne fonctionnent pas.
Vous devez saisir les données manuellement.
En générant une clé API, vous pouvez :
✅ Automatiser vos processus (ajout de prospects, déclenchement de campagnes, synchronisation de données)
✅ Créer des intégrations sur mesure avec vos outils
✅ Accéder par programmation aux fonctionnalités de lemlist
Avant de commencer
Avant de générer une clé API, vérifiez les points suivants :
Vous avez un compte lemlist avec accès aux Paramètres.
Vous savez quel outil ou quelle application a besoin de la clé API (Clay, Zapier, intégration sur mesure).
Vous avez prévu un endroit sûr où conserver la clé (un gestionnaire de mots de passe est recommandé).
Étape 1 : ouvrir la page Intégrations (paramètres de l’API)
Cliquez sur votre icône de profil (en bas à gauche), puis sélectionnez Paramètres.
Dans les Paramètres, ouvrez Intégrations, puis cliquez sur Générer.
Étape 2 : nommer et créer votre clé API
Donnez à votre clé API un nom explicite qui indique à quoi elle sert.
Exemples :
Clay IntegrationZapier AutomationCustom CRM Sync
Entrez le nom, puis cliquez sur Créer la clé.
Étape 3 : copier et conserver votre clé API en lieu sûr
⚠️ Important : vous ne pouvez consulter la clé API qu’une fois, juste après sa création. Si vous la perdez, vous devrez en générer une nouvelle.
Copiez la clé API et collez-la dans :
Un gestionnaire de mots de passe (1Password, LastPass, Bitwarden)
Un document sécurisé
L’outil d’intégration qui en a besoin (Clay, Zapier, etc.)
💡 Ne partagez jamais votre clé API publiquement (ne la collez pas sur Slack, dans un email ou sur GitHub).
Étape 4 : gérer vos clés API
Une fois vos clés API générées, vous pouvez les gérer dans la section Clés API de la page Intégrations. Si la liste est repliée, cliquez sur la flèche pour la développer.
Consulter la dernière utilisation
La colonne Dernière utilisation indique quand chaque clé API a été utilisée pour la dernière fois.
Vous pouvez ainsi repérer les clés inutilisées ou inactives.
Renommer une clé API
Cliquez sur l’icône de modification (✏️) à côté de la clé API.
Entrez un nouveau nom.
Enregistrez.
Supprimer une clé API
Si vous n’avez plus besoin d’une clé API :
Cliquez sur l’icône Supprimer (🗑️) à côté de la clé.
Confirmez la suppression.
⚠️ La suppression d’une clé API révoque immédiatement l’accès de toutes les intégrations qui l’utilisent. Vérifiez que la clé n’est plus utilisée avant de la supprimer.
Comment vérifier que tout fonctionne ?
✓ Votre clé API apparaît dans la section Clés API sous le nom que vous lui avez donné.
✓ Vous avez bien copié la clé API et l’avez conservée en lieu sûr.
✓ L’outil d’intégration (Clay, Zapier, etc.) se connecte à l’aide de la clé API.
✓ La colonne Dernière utilisation se met à jour lorsque la clé est utilisée.
Pour faire un test, collez la clé API dans l’outil d’intégration et vérifiez que la connexion s’établit.
Problèmes courants et solutions
Causes fréquentes de l’erreur « No API Key Provided »
En-têtes de requête incorrects : la clé API n’est pas incluse dans les en-têtes attendus.
Méthode d’authentification inadaptée : la méthode utilisée n’est pas la bonne, par exemple si la clé API est placée dans le corps JSON de la requête ou dans un en-tête non pris en charge.
Clé API non générée ou mal configurée : la clé API n’a pas été créée ou n’a pas été copiée correctement.
Restrictions du compte : votre type de compte ne permet peut-être pas d’utiliser les intégrations via l’API.
Problème : vous ne trouvez pas la section API
Cause : vous n’avez peut-être pas les autorisations nécessaires, ou la section API est masquée.
Solution :
Vérifiez que vous êtes connecté en tant qu’administrateur ou que vous disposez des autorisations d’accès à l’API.
Contactez l’administrateur de votre espace de travail si la section API n’apparaît pas.
Problème : la clé API ne fonctionne pas dans l’intégration
Cause : la clé API a été mal copiée, a expiré ou a été révoquée.
Solution :
Vérifiez que vous avez copié toute la clé, sans espace ni caractère en trop.
Vérifiez si la clé API a été supprimée ou régénérée.
Générez une nouvelle clé API et mettez à jour l’intégration.
Vérifiez que la clé API figure dans les en-têtes au bon format (par exemple : « Authorization: Bearer YOUR_API_KEY »).
Si vous utilisez l’authentification HTTP Basic, respectez les consignes indiquées pour le nom d’utilisateur et le mot de passe.
Problème : vous avez perdu la clé API avant de la copier
Cause : une clé API n’est visible qu’une seule fois, au moment de sa création.
Solution :
Supprimez la clé API perdue.
Générez une nouvelle clé API.
Copiez-la et enregistrez-la immédiatement dans un gestionnaire de mots de passe.
Problème : la clé API est marquée « Never Used », mais l’intégration fonctionne
Cause : la mise à jour de la colonne Dernière utilisation peut prendre quelques minutes.
Solution :
Patientez 5 à 10 minutes et actualisez la page.
Si « Never Used » s’affiche toujours après 24 heures, vérifiez que l’intégration utilise la bonne clé.
Bonnes pratiques
Choisissez des noms explicites : nommez vos clés API selon leur usage (par exemple « Clay Integration » ou « Zapier Workflow ») pour les retrouver facilement.
Conservez vos clés dans un gestionnaire de mots de passe : utilisez 1Password, LastPass ou Bitwarden pour stocker vos clés API en toute sécurité, avec des notes précisant où elles sont utilisées.
Générez une clé distincte pour chaque intégration : n’utilisez pas la même clé API pour plusieurs outils. Vous pourrez ainsi révoquer un accès plus facilement, sans interrompre les autres intégrations.
Vérifiez vos clés chaque trimestre : passez en revue vos clés API tous les 3 mois. Supprimez les clés inutilisées ou inactives pour réduire les risques de sécurité.
Renouvelez vos clés régulièrement : pour plus de sécurité, régénérez vos clés API tous les 6 à 12 mois, surtout pour les intégrations critiques.
Notez où chaque clé est utilisée : gardez une trace de l’utilisation de chaque clé API (par exemple « La clé Clay Integration est utilisée dans la table Clay XYZ »).
Surveillez la colonne Dernière utilisation : consultez-la régulièrement pour repérer les clés potentiellement compromises ou dont vous n’avez plus besoin.
Documentation avancée de l’API
Pour configurer correctement l’authentification à l’API, incluez votre clé API dans l’en-tête de la requête en respectant les règles d’authentification de lemlist. Deux méthodes sont possibles :
Méthode 1 : jeton Bearer dans l’en-tête Authorization
Utilisez cette méthode lorsque l’authentification par jeton Bearer est indiquée. L’en-tête de la requête doit contenir :
Authorization: Bearer YOUR_API_KEY
Points importants :
Évitez d’utiliser d’autres en-têtes personnalisés, comme
Api-Keyoux-api-key.Ne placez pas la clé API dans les paramètres de requête ni dans le corps JSON.
Méthode 2 : authentification HTTP Basic
Pour certains points d’accès, lemlist exige une authentification HTTP Basic avec un nom d’utilisateur vide et la clé API comme mot de passe. Exemple :
Commande 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]"}'Code 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]"} )
Pour découvrir toutes les possibilités de l’API (points d’accès, paramètres, exemples), rendez-vous sur :
Vous y trouverez :
La documentation complète de l’API (ajout de prospects, création de campagnes, récupération de statistiques, etc.)
Des exemples de code dans plusieurs langages (JavaScript, Python, cURL)
Les détails de l’authentification
Les limites de fréquence des requêtes et les bonnes pratiques