Elle est conçue pour les utilisateurs souhaitant automatiser les flux de données entre Kanbox et des systèmes externes (CRM, formulaires, outils d’enrichissement, applications internes, etc.).
Pour la liste complète des endpoints, formats de requêtes et réponses, consultez la documentation Swagger :
https://api.kanbox.io/docs#/
Disponibilité de l’API
L’API Kanbox est disponible uniquement pour les utilisateurs disposant d’un abonnement PRO.
Si votre compte n’est pas en PRO, l’accès à l’API et à la clé API ne sera pas disponible.
Où trouver votre clé API
Vous pouvez générer et gérer votre clé API directement depuis votre compte Kanbox.
Étapes :
Ouvrez Settings
Allez dans API
Activez la clé API
Copiez votre clé
Cette clé est nécessaire pour authentifier toutes les requêtes envoyées à l’API Kanbox.
Authentification
L’API Kanbox utilise une authentification via header statique.
Cela signifie que chaque requête doit inclure votre clé API dans les headers afin que Kanbox puisse identifier et autoriser votre compte.
Principe
La clé API est unique à votre workspace
Elle reste identique jusqu’à ce que vous la régénériez
Elle doit être envoyée avec chaque requête
Exemple
X-API-Key: YOUR_API_KEY
Veillez à conserver cette clé de manière sécurisée et à ne jamais l’exposer côté frontend ou dans des dépôts publics.
Modèle de données Kanbox : Leads vs Members
Lors de l’utilisation de l’API, il est important de comprendre la différence entre un lead et un member dans Kanbox.
Lead
Un lead est un profil LinkedIn scrapé et importé dans Kanbox.
Les leads sont stockés dans la section Leads. À ce stade, il s’agit de prospects potentiels qui ne sont pas encore liés à votre activité (conversations, campagnes, etc.).
Member
Un member est un lead qui est devenu lié à votre activité dans Kanbox.
Cela se produit lorsqu’un lead est ajouté dans :
l’Inbox
les Pipelines
les Campagnes
Autrement dit, un member est un lead activé dans vos opérations et suivi dans vos workflows.
Résumé
Lead = profil LinkedIn importé
Member = lead lié à votre activité Kanbox
Cette distinction est essentielle pour structurer correctement vos intégrations.
Principales fonctionnalités de l’API
L’API Kanbox couvre les actions principales nécessaires pour connecter Kanbox à votre écosystème.
1. Ajouter des leads dans Kanbox
Vous pouvez envoyer des leads LinkedIn dans Kanbox via l’API, sans passer par un import manuel.
Cas d’usage :
alimenter Kanbox depuis vos outils de prospection
envoyer des leads depuis des formulaires ou workflows d’enrichissement
centraliser vos sources de leads
2. Mettre à jour des contacts
L’API permet de mettre à jour les données des contacts déjà présents dans Kanbox.
Cas d’usage :
enrichissement des données
synchronisation avec un CRM
mise à jour d’attributs externes
3. Créer des intégrations personnalisées
L’API vous permet de connecter Kanbox à votre stack et d’automatiser des actions.
Cas d’usage :
synchronisation avec un CRM
automatisation de workflows internes
intégration avec des outils tiers
alignement des données entre systèmes
Cas d’usage typiques
Voici quelques exemples d’utilisation de l’API Kanbox :
Importer des leads collectés en dehors de Kanbox
Synchroniser les données avec un CRM
Enrichir les fiches prospects
Automatiser l’ingestion de leads depuis des formulaires ou outils de scraping
Construire des workflows personnalisés autour de la prospection
Bonnes pratiques
Pour une utilisation sécurisée et fiable :
Gardez votre clé API privée
N’exposez pas la clé côté client
Privilégiez des appels côté serveur
Consultez la documentation Swagger avant implémentation
Vérifiez si votre cas d’usage concerne un lead ou un member
Référence API
Pour tous les détails techniques, incluant :
les routes disponibles
les paramètres
les formats de requêtes
les schémas de réponse
consultez la documentation officielle :