> ## Documentation Index
> Fetch the complete documentation index at: https://docs.agentova.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Connecter Agentova à Zapier

> Créez une clé API dans Agentova, puis connectez-la dans Zapier

## 1. Créer une clé API dans Agentova

**1. Ouvrir Paramètres → API dans Agentova**

Dans Agentova, cliquez sur le nom de votre espace de travail, en haut de la barre latérale, puis sur **Paramètres**. Choisissez ensuite **API**, dans la section **ESPACE DE TRAVAIL**. Vous devez être **administrateur** de l'espace de travail : les autres membres peuvent ouvrir la page, mais pas créer ni révoquer de clé.

![Paramètres → API dans Agentova, avant la création de toute clé](https://mintcdn.com/agentova-2c667f5d/Xl6jEAYNYyd4kO2m/images/agentova/api-empty.jpg?fit=max\&auto=format\&n=Xl6jEAYNYyd4kO2m\&q=85\&s=15a707ad49fb755372596f47d3c915a6)

Paramètres → API, avant la première clé

**2. Créer une clé et la copier aussitôt**

Cliquez sur **Créer une clé**, donnez-lui un nom qui dit où elle sert, par exemple « Zapier — équipe marketing », et confirmez avec **Créer la clé**. La clé ressemble à `agk_live_…` et n'est **affichée qu'une seule fois** : copiez-la, puis fermez la fenêtre avec **J'ai copié ma clé**.

![La fenêtre Créer une clé API, avec le nom de la clé renseigné](https://mintcdn.com/agentova-2c667f5d/Xl6jEAYNYyd4kO2m/images/agentova/create-key.jpg?fit=max\&auto=format\&n=Xl6jEAYNYyd4kO2m\&q=85\&s=a2aab0c463f05e76aedf84b62835fbb8)

Nommez la clé d'après l'outil qui va l'utiliser

![La fenêtre Votre nouvelle clé API, avec le bouton de copie à côté de la clé](https://mintcdn.com/agentova-2c667f5d/Xl6jEAYNYyd4kO2m/images/agentova/key-created.jpg?fit=max\&auto=format\&n=Xl6jEAYNYyd4kO2m\&q=85\&s=f08c28fd122986c1e983894d229001fc)

La clé n'est affichée qu'une fois : copiez-la avec le bouton de droite (masquée ici)

**3. La garder secrète**

Une clé donne accès à **tout l'espace de travail** : lister ses automatisations, les mettre en pause et les réactiver, lire ses leads et ses exécutions, gérer ses abonnements webhook. Tous les administrateurs de l'espace de travail sont prévenus quand une clé est créée. Vous pouvez avoir jusqu'à 10 clés actives ; révoquez celles qui ne servent plus.

Une clé révoquée cesse de fonctionner immédiatement, partout où elle est utilisée. Par défaut, les abonnements webhook créés avec elle sont supprimés en même temps : les déclencheurs qui en dépendent ne reçoivent plus d'événements — voir [Sécurité](https://docs.agentova.ai/security.md).

## 2. La connecter dans Zapier

**1. Accepter l'invitation (tant que l'application est sur invitation)**

Ouvrez le lien d'invitation qu'Agentova vous a envoyé, en étant connecté au compte Zapier que vous allez utiliser, et acceptez-la. Sans cette étape, l'application Agentova n'apparaît pas dans l'éditeur de Zap. Une fois l'application publique, passez cette étape.

**2. Ajouter une étape Agentova à un Zap**

Dans l'éditeur de Zap, ajoutez un déclencheur ou une action et cherchez **Agentova**. Choisissez l'événement voulu.

![Le panneau d'une étape Zapier avec l'application Agentova, la liste des déclencheurs Automation Status Changed, New Lead et Run Completed marqués Instant, et le bouton Sign in du compte](https://mintcdn.com/agentova-2c667f5d/Xl6jEAYNYyd4kO2m/images/zapier/trigger-events.jpg?fit=max\&auto=format\&n=Xl6jEAYNYyd4kO2m\&q=85\&s=25412601d6364bfdc51e40201bc23a2a)

L'application Agentova dans l'éditeur de Zap : ses trois déclencheurs instantanés et le bouton Sign in

**3. Se connecter**

Cliquez sur **Sign in** (ou **Connect a new account**) et collez votre clé dans le champ **API key**.

**4. Vérifier la connexion**

Zapier teste la clé immédiatement. Quand elle fonctionne, le compte est nommé d'après le début de sa clé — par exemple **Key agk\_live\_a1b2…** — le même début qu'Agentova affiche dans **Paramètres → API**. C'est ainsi que vous savez quelle clé utilise chaque compte Zapier, par exemple avant d'en révoquer une.

![Le panneau d'une étape Zapier dont le compte connecté s'appelle Key agk\_live\_a1b2…](https://mintcdn.com/agentova-2c667f5d/Xl6jEAYNYyd4kO2m/images/zapier/connected-account.jpg?fit=max\&auto=format\&n=Xl6jEAYNYyd4kO2m\&q=85\&s=b475c3f8430f3f8c9a4edac1eaa053b6)

Le compte connecté, nommé d'après le début de sa clé

![Paramètres → API avec deux clés, Zapier et n8n, dont seul le début est affiché (agk\_live\_a1b2), et l'adresse de l'API](https://mintcdn.com/agentova-2c667f5d/Xl6jEAYNYyd4kO2m/images/agentova/api-keys-list.jpg?fit=max\&auto=format\&n=Xl6jEAYNYyd4kO2m\&q=85\&s=0a4e47a58289cb0c86efb843b05dacf5)

Paramètres → API affiche le début de chaque clé : celui-là même que Zapier utilise pour nommer le compte connecté

> [!TIP]
>
> Une clé = un espace de travail. Pour travailler avec plusieurs espaces de travail Agentova, connectez un compte par espace de travail, chacun avec sa propre clé.

## Si la connexion échoue

| Message | Ce que ça veut dire | Que faire |
| - | - | - |
| « Invalid or revoked API key… » | La clé est fausse, incomplète, ou a été révoquée | Copiez de nouveau la clé, ou créez-en une nouvelle |
| « Your Agentova subscription doesn't currently allow API access… » | L'abonnement de l'espace de travail est impayé, en pause ou incomplet | Régularisez l'abonnement dans **Paramètres → Abonnement** (votre formule) ou **Paramètres → Facturation** (moyen de paiement, factures) |

## Quand vous révoquez une clé

Les **actions et recherches** Agentova qui utilisent la clé s'arrêtent : Zapier marque le compte comme expiré, vous prévient par e-mail, et met en attente les exécutions de ces Zaps jusqu'à ce que vous reconnectiez le compte avec une nouvelle clé.

Les **déclencheurs** Agentova dépendent de la case cochée par défaut dans la fenêtre **Révoquer cette clé ?**, qui supprime les abonnements webhook créés avec la clé :

* **Case cochée** (par défaut) : les inscriptions des Zaps sont supprimées avec la clé, et leurs déclencheurs ne reçoivent plus d'événements. Une fois le compte reconnecté avec une nouvelle clé, **désactivez puis réactivez chaque Zap** pour qu'il s'inscrive de nouveau.
* **Case décochée** : les déclencheurs continuent de recevoir les événements, tant que l'administrateur qui a créé l'ancienne clé reste administrateur de l'espace de travail. Pour ne plus en dépendre, désactivez puis réactivez chaque Zap une fois le compte reconnecté avec la nouvelle clé. Pour les arrêter plus tard, désactivez leurs Zaps, ou supprimez leurs abonnements dans le tableau **Abonnements webhook** de **Paramètres → API**.

Voir [Révoquer une clé](https://docs.agentova.ai/security.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.