Clés API
Créez une clé API pour brancher Zapier, Make ou un script à Caryon Lead sans partager votre mot de passe.
Une clé API sert à brancher Zapier, Make ou un script à Caryon Lead sans partager votre mot de passe. Elle agit en votre nom, avec vos droits.
Formule
Les clés API sont incluses dans les formules Business et Enterprise, et pendant l'essai. En Starter, elles sont refusées.
Créer une clé
Ouvrez vos connexions
Dans Caryon ID, ouvrez « Connexions », carte « Clés API », puis cliquez sur « Créer une clé ».
Remplissez le formulaire
- Nom : l'outil qui l'utilisera (« Zapier », par exemple). Une clé par outil.
- Espace : une clé ne vaut que pour un espace. Un espace non éligible est grisé avec sa raison.
- Rôle : « Mon rôle » ou un rôle qui donne moins de droits que le vôtre. Jamais plus. Avec « Mon rôle », la clé d'un propriétaire ou d'un administrateur agit comme lui, par exemple pour modifier l'action d'un autre membre ; avec un autre rôle, jamais.
- Lecture seule : la clé pourra consulter, sans rien modifier.
- Durée : 30 jours, 90 jours (par défaut), 1 an ou sans expiration.
Copiez la clé
Elle commence par cyk_ et n'est affichée qu'une fois. Cliquez sur « Copier la clé » et rangez-la dans votre outil. Si vous la perdez, révoquez-la et créez-en une autre.
Utiliser la clé
Envoyez-la dans l'en-tête de chaque appel :
Authorization: Bearer cyk_…Voir la référence de l'API. La même clé fonctionne aussi avec le serveur des agents IA.
Limite : 30 appels par minute et 5 000 par jour par clé.
Suivre, renouveler, révoquer
- Chaque clé affiche son espace, son rôle, son expiration et son dernier usage. Une clé échue est marquée « Expirée » et reste listée pour pouvoir être retirée.
- Sept jours avant l'expiration, vous recevez la notification « Votre clé API « Zapier » expire le … ». Créez-en une nouvelle pour que vos outils continuent de fonctionner.
- « Révoquer » refuse la clé aussitôt (« Annuler » reste proposé 5 secondes).
- Si un membre quitte l'espace ou en est retiré, ses clés sont révoquées.
Pour les propriétaires et administrateurs
Dans Caryon ID, ouvrez l'espace puis « API et agents IA » :
- deux interrupteurs, allumés par défaut : « Clés API » et « Agents IA ». Éteint, un interrupteur fait refuser les clés (ou agents) existants sans les révoquer ;
- la liste des clés et agents de tous les membres, que vous pouvez révoquer.
Ce que les clés écrivent se retrouve dans le Journal des modifications.
Bonnes pratiques
- Traitez une clé comme un mot de passe : jamais dans un message, un document partagé ou un dépôt de code.
- Préférez « Lecture seule » quand l'outil n'a qu'à consulter.
- Choisissez une durée courte, et une clé par outil.
Une question sans réponse ici ? Écrivez-nous à contact@caryon.app.
Brancher un agent IA (Claude, ChatGPT)
Connectez Claude ou ChatGPT à Caryon Lead pour lui demander de consulter et mettre à jour votre CRM en langage naturel.
Référence de l'API
L'essentiel pour appeler l'API de Caryon Lead depuis un script ou un outil : authentification, ressources, pagination, erreurs et limites.