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

# Credentials

> Connect n8n to your Agentova workspace

## 1. Create an API key in Agentova

**1. Open Paramètres → API in Agentova**

The Agentova app is in French. Click your workspace name at the top of the sidebar, then **Paramètres** (Settings), and pick **API** in the **ESPACE DE TRAVAIL** section. You need to be an **admin** of the workspace: other members can open the page, but can't create or revoke keys.

![Paramètres → API in Agentova, before any key is created](https://mintcdn.com/agentova-2c667f5d/Xl6jEAYNYyd4kO2m/images/agentova/api-empty.jpg?fit=max\&auto=format\&n=Xl6jEAYNYyd4kO2m\&q=85\&s=15a707ad49fb755372596f47d3c915a6)

Paramètres → API, before the first key

**2. Create a key and copy it right away**

Click **Créer une clé** (Create a key), give it a name that says where it's used, for example “Zapier — marketing team”, and confirm with **Créer la clé**. The key looks like `agk_live_…` and is **shown only once**: copy it, then close the window with **J'ai copié ma clé** (I've copied my key).

![The Créer une clé API window, with the key name filled in](https://mintcdn.com/agentova-2c667f5d/Xl6jEAYNYyd4kO2m/images/agentova/create-key.jpg?fit=max\&auto=format\&n=Xl6jEAYNYyd4kO2m\&q=85\&s=a2aab0c463f05e76aedf84b62835fbb8)

Name the key after the tool that will use it

![The Votre nouvelle clé API window, with the copy button next to the key](https://mintcdn.com/agentova-2c667f5d/Xl6jEAYNYyd4kO2m/images/agentova/key-created.jpg?fit=max\&auto=format\&n=Xl6jEAYNYyd4kO2m\&q=85\&s=f08c28fd122986c1e983894d229001fc)

The key is shown once: copy it with the button on the right (masked here)

**3. Keep it secret**

One key gives access to the **whole workspace**: listing its automations, pausing and reactivating them, reading its leads and runs, managing its webhook subscriptions. Every admin of the workspace is notified when a key is created. You can have up to 10 active keys; revoke the ones you no longer use.

A revoked key stops working immediately, everywhere it's used. By default, the webhook subscriptions created with it are deleted with it, so the triggers that rely on them stop receiving events — see [Security](https://docs.agentova.ai/en/security.md#revoking-a-key).

## 2. Create the credential in n8n

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

**2. Fill in the two fields**

| Field | Value |
| - | - |
| **Access Token** | Your key, `agk_live_…` |
| **Base URL** | `https://core-api.agentova.ai/v1`, unless Agentova gives you another address. It's also shown, ready to copy, in the **Brancher Zapier ou n8n** box of **Paramètres → API** |

![The Brancher Zapier ou n8n box, with the API address and its copy button](https://mintcdn.com/agentova-2c667f5d/feKWke85qJU4qSmG/images/agentova/api-address.jpg?fit=max\&auto=format\&n=feKWke85qJU4qSmG\&q=85\&s=9dd61bf191df0e8245a57f694259a587)

The API address, ready to copy

**3. Save**

n8n tests the key right away. **Connection tested successfully** means you're ready.

![The Agentova account credential in n8n, with the Connection tested successfully message, the masked key and the Base URL](https://mintcdn.com/agentova-2c667f5d/feKWke85qJU4qSmG/images/n8n/credential-success.jpg?fit=max\&auto=format\&n=feKWke85qJU4qSmG\&q=85\&s=dfd90ad20592ab5cfe608ad85bd5b7e9)

The saved credential: n8n tested the key successfully

> [!TIP]
>
> One key = one workspace. For several workspaces, create one credential per workspace and pick the right one in each node.

## If the test fails

| Message | What it means | What to do |
| - | - | - |
| “Invalid or revoked Agentova API key…” | The key is wrong, incomplete or revoked | Paste the key again, or create a new one |
| “This Agentova workspace has no access to the API…” | The key is valid, but the workspace's subscription is unpaid, paused or incomplete | Fix the subscription in **Paramètres → Abonnement** (the plan) or **Paramètres → Facturation** (payment method, invoices) |
| “No Agentova API at this Base URL…” | The Base URL is wrong | Set it back to `https://core-api.agentova.ai/v1` |
| A connection error (`ENOTFOUND`, `ECONNREFUSED`…) | Your n8n can't reach the Agentova API | Check the Base URL and your n8n's internet access |
| “Agentova rate limit reached…”, “Agentova internal error…” or “The Agentova API is temporarily unavailable…” | A temporary problem on Agentova's side | Retry the test a bit later |

## When you revoke a key

The **Agentova** node stops at once in every workflow that uses the credential: each operation fails with “Invalid or revoked Agentova API key” until you update the credential with a new key.

An active **Agentova Trigger** depends on the box ticked by default in the **Révoquer cette clé ?** window, which deletes the webhook subscriptions created with the key:

* **Box ticked** (the default): the trigger's subscription is deleted with the key, and the trigger stops receiving events. Update the credential with a new key, then **deactivate and activate the workflow**: the trigger registers again.
* **Box unticked**: the trigger keeps receiving events. To stop it, update the credential with a new key, then deactivate the workflow — or delete its subscription in the **Abonnements webhook** table of **Paramètres → API** (Settings → API).

See [Revoking a key](https://docs.agentova.ai/en/security.md#revoking-a-key).


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