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

# Connect Agentova to Zapier

> Create an API key in Agentova, then connect it in Zapier

## 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. Connect it in Zapier

**1. Accept the invitation (while the app is invite-only)**

Open the invitation link Agentova sent you, while signed in to the Zapier account you'll use, and accept it. Without this step, the Agentova app doesn't show up in the Zap editor. Once the app is public, skip this step.

**2. Add an Agentova step to a Zap**

In the Zap editor, add a trigger or an action and search for **Agentova**. Pick the event you want.

![A Zapier step panel with the Agentova app, the trigger list Automation Status Changed, New Lead and Run Completed marked Instant, and the account's Sign in button](https://mintcdn.com/agentova-2c667f5d/Xl6jEAYNYyd4kO2m/images/zapier/trigger-events.jpg?fit=max\&auto=format\&n=Xl6jEAYNYyd4kO2m\&q=85\&s=25412601d6364bfdc51e40201bc23a2a)

The Agentova app in the Zap editor: its three instant triggers and the Sign in button

**3. Sign in**

Click **Sign in** (or **Connect a new account**) and paste your key in the **API key** field.

**4. Check the connection**

Zapier tests the key right away. When it works, the account is labeled with the beginning of its key — for example **Key agk\_live\_a1b2…** — the same beginning Agentova shows in **Paramètres → API**. That's how you know which key each Zapier account uses, for example before revoking one.

![A Zapier step panel whose connected account is named 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)

The connected account, labeled with the beginning of its key

![Paramètres → API with two keys, Zapier and n8n, showing only their beginning (agk\_live\_a1b2), and the API address](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 shows the beginning of each key: the same one Zapier uses to label the connected account

> [!TIP]
>
> One key = one workspace. To work with several Agentova workspaces, connect one account per workspace, each with its own key.

## If the connection fails

| Message | What it means | What to do |
| - | - | - |
| “Invalid or revoked API key…” | The key is wrong, incomplete, or was revoked | Copy the key again, or create a new one |
| “Your Agentova subscription doesn't currently allow API access…” | 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) |

## When you revoke a key

The Agentova **actions and searches** that use the key stop: Zapier marks the account as expired, emails you, and holds those Zap runs until you reconnect the account with a new key.

The Agentova **triggers** depend 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 Zaps' registrations are deleted with the key, and their triggers stop receiving events. Once the account is reconnected with a new key, **turn each Zap off and on** to register again.
* **Box unticked**: the triggers keep receiving events, as long as the admin who created the old key remains an admin of the workspace. To stop depending on it, turn each Zap off and on once the account is reconnected with the new key. To stop them later, turn their Zaps off, or delete their subscriptions in the **Abonnements webhook** table of **Paramètres → 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.