> ## 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.

# Identifiants

> Connectez n8n à votre espace de travail Agentova

## 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. Créer l'identifiant dans n8n

**1. Credentials → Add credential → Agentova API**

**2. Remplissez les deux champs**

| Champ | Valeur |
| - | - |
| **Access Token** | Votre clé, `agk_live_…` |
| **Base URL** | `https://core-api.agentova.ai/v1`, sauf si Agentova vous communique une autre adresse. Elle est aussi affichée, prête à copier, dans l'encadré **Brancher Zapier ou n8n** de **Paramètres → API** |

![L'encadré Brancher Zapier ou n8n, avec l'adresse de l'API et son bouton de copie](https://mintcdn.com/agentova-2c667f5d/feKWke85qJU4qSmG/images/agentova/api-address.jpg?fit=max\&auto=format\&n=feKWke85qJU4qSmG\&q=85\&s=9dd61bf191df0e8245a57f694259a587)

L'adresse de l'API, prête à copier

**3. Enregistrez (Save)**

n8n teste la clé aussitôt. Le message **Connection tested successfully** signifie que tout est prêt.

![L'identifiant Agentova account dans n8n, avec le message Connection tested successfully, la clé masquée et la Base URL](https://mintcdn.com/agentova-2c667f5d/feKWke85qJU4qSmG/images/n8n/credential-success.jpg?fit=max\&auto=format\&n=feKWke85qJU4qSmG\&q=85\&s=dfd90ad20592ab5cfe608ad85bd5b7e9)

L'identifiant enregistré : n8n a testé la clé avec succès

> [!TIP]
>
> Une clé = un espace de travail. Pour plusieurs espaces de travail, créez un identifiant par espace et choisissez le bon dans chaque nœud.

## Si le test échoue

| Message | Ce que cela signifie | Que faire |
| - | - | - |
| « Invalid or revoked Agentova API key… » | La clé est fausse, incomplète ou révoquée | Collez la clé à nouveau, ou créez-en une nouvelle |
| « This Agentova workspace has no access to the API… » | La clé est valide, mais 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) |
| « No Agentova API at this Base URL… » | La Base URL est fausse | Remettez `https://core-api.agentova.ai/v1` |
| Une erreur de connexion (`ENOTFOUND`, `ECONNREFUSED`…) | Votre n8n n'arrive pas à joindre l'API Agentova | Vérifiez la Base URL et l'accès Internet de votre n8n |
| « Agentova rate limit reached… », « Agentova internal error… » ou « The Agentova API is temporarily unavailable… » | Un problème temporaire côté Agentova | Relancez le test un peu plus tard |

## Quand vous révoquez une clé

Le nœud **Agentova** s'arrête aussitôt dans tous les workflows qui utilisent l'identifiant : chaque opération échoue avec « Invalid or revoked Agentova API key » tant que vous n'avez pas mis à jour l'identifiant avec une nouvelle clé.

Pour un **Agentova Trigger** actif, tout dépend 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) : l'abonnement du déclencheur est supprimé avec la clé, et le déclencheur ne reçoit plus d'événements. Mettez à jour l'identifiant avec une nouvelle clé, puis **désactivez et réactivez le workflow** : le déclencheur se réenregistre.
* **Case décochée** : le déclencheur continue de recevoir des événements. Pour l'arrêter, mettez à jour l'identifiant avec une nouvelle clé, puis désactivez le workflow — ou supprimez son abonnement dans le tableau **Abonnements webhook** de **Paramètres → API**.

Voir la révocation d'une clé dans la page [Sécurité](https://docs.agentova.ai/security.md).


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