# Créer une clé API

Lecture ou écriture ; le secret ne s'affiche qu'une seule fois.

- Rôle : Gestionnaire
- Durée : 2 min
- Sur : Web
- Centre d’apprentissage : https://callizy.ca/fr/apprendre/cle-api
- Parcours intégrations · Leçon 8
- Ouvrir cet écran dans Callizy : https://app.callizy.ca/fr/manager?view=integrations
- La page sur callizy.ca : https://callizy.ca/docs

## Avant de commencer

- Être gestionnaire du compte Callizy.
- Le serveur ou l’outil qui gardera la clé : le secret ne s’affiche qu’une fois.

## Pas à pas

5 étapes, environ 2 min.

### 1. Ouvrez Développeurs (10 s)

Dans l’Administration, **Réglages**, puis **Développeurs** : l’onglet **Clés API** s’ouvre.

Menu : Administration › Réglages › Développeurs

### 2. Nommez la clé (20 s)

Cliquez **Nouvelle clé**. Dans **Nom de la clé**, dites à quoi elle sert, par exemple « Intégration CRM ».

### 3. Choisissez l’accès (20 s)

**Lecture** : lire les appels, textos, contacts et statistiques. **Lecture et écriture**, choisi au départ : en plus, appeler, texter et créer des contacts. Ne donnez que ce dont l’outil a besoin, puis cliquez **Générer**.

### 4. Copiez la clé et le secret (30 s)

« Clé créée. Copiez-la maintenant. » : copiez la **Clé publique** et le **Secret** avec leurs boutons, puis cliquez **C’est noté**. Le secret ne sera plus jamais affiché.

### 5. Appelez l’API (30 s)

Chaque requête porte deux en-têtes : **X-API-Key**, la clé, qui commence par clz_, et **X-API-Secret**. Cette requête renvoie la fiche de votre entreprise.

```
curl https://api.callizy.ca/api/v1/company/ -H "X-API-Key: clz_…" -H "X-API-Secret: …"
```

## À retenir

- Le secret ne s’affiche qu’une fois : gardez-le sur votre serveur.
- Une clé en Lecture reçoit une erreur 403 sur toute écriture.
- Désactiver une clé se défait ; la supprimer arrête les intégrations qui l’utilisent.

## Ça ne marche pas ?

### Callizy affiche « Le nom est requis »

1. Donnez un nom à la clé : le bouton **Générer** s’active ensuite.

### Vous avez perdu le secret

1. Il ne s’affiche plus : créez une nouvelle clé, branchez-la, puis supprimez l’ancienne.

### L’outil reçoit une erreur 403 en écrivant

1. La clé est en Lecture : créez-en une en **Lecture et écriture**.

### L’outil ne se connecte plus

1. Dans la liste, la clé est-elle « Désactivée » ? Réactivez-la avec le bouton de sa ligne.

## Questions fréquentes

### Faut-il une clé pour Claude ou ChatGPT ?

Non : le serveur MCP se connecte avec votre compte Callizy. Voir [Callizy dans Claude ou ChatGPT](https://callizy.ca/fr/apprendre/claude-chatgpt).

### Où est la documentation ?

Sur callizy.ca/docs. L’adresse de base de l’API est https://api.callizy.ca/api/v1/.

### Est-ce inclus dans mon abonnement ?

Oui, dans tous les forfaits, dès Solo.

Mis à jour le 27 octobre 2026.