Skip to main content
The Agentova public API (v1) gives you access to your workspace’s automations, leads and runs, and lets you pause or reactivate automations. It also notifies you in real time, through webhooks, when a lead comes in, a run finishes, or an automation’s status changes.
Not a developer? The Zapier and n8n tabs are step-by-step guides for using Agentova in those tools, without writing code.
The API is meant to be called from a server: it authenticates with a secret key, and it doesn’t answer calls made from a web browser (no CORS).

​
Endpoints

List automations

GET /automations — every automation of the workspace, filtered by status, type or agent.

Retrieve an automation

GET /automations/{id} — one automation and its current status.

Update an automation's status

PATCH /automations/{id} — pause or reactivate an automation.

List runs

GET /runs — what your automations did, across the whole workspace.

List leads

GET /leads — the leads captured by your workspace, in one unified shape.

List webhook subscriptions

GET /webhooks — the subscriptions of the workspace, active and disabled.

Create a webhook subscription

POST /webhooks — receive lead.created, run.completed or automation.status_changed.

Delete a webhook subscription

DELETE /webhooks/{id} — stop receiving events at that address.
The API Reference tab also documents GET /automations/{id}/runs, the runs of a single automation.
v1 doesn’t create or delete automations, and has no manual trigger. It’s a stable, deliberately small contract: what you rely on today keeps working — see Versioning.

​
Get started

Quickstart

Create an API key, make your first call, and receive a real webhook in under 10 minutes.

Concepts

Which automations, lead sources and runs the API covers — and what it doesn’t.

Webhooks & signatures

Deliveries, retries, and how to verify a signature, with a test vector.

Security

Storing and rotating keys, webhook secrets, data retention.

​
How this documentation is built

The API Reference tab isn’t written by hand: it’s generated from Agentova’s OpenAPI contract, which you can download at https://docs.agentova.ai/openapi/openapi-v1.yaml. If a field, an error code or an endpoint looks wrong here, the contract is the source of truth to check first. Every page is also available as Markdown: use the menu at the top of a page to copy it or open it in an AI assistant. The list of all pages, for AI tools, is at https://docs.agentova.ai/llms.txt.