API Documentation

Authentication

All requests to the Aiaxovio API are authenticated with a bearer token. Include your API key in the Authorization header of every request.

Authorization: Bearer aiax_live_xxxxxxxxxxxxxxxx

Requests without a valid key return a 401 Unauthorized response.

API Keys

Generate and manage API keys from your dashboard under Settings → API Keys. Each key can be scoped to specific automations and revoked at any time.

REST Endpoints

Base URL: https://api.aiaxovio.com/v1

Webhook Examples

Subscribe to events and receive a JSON payload whenever a workflow runs.

{
  "event": "lead.captured",
  "data": {
    "lead_id": "ld_8f2k3",
    "source": "website_form",
    "email": "customer@example.com"
  },
  "timestamp": "2026-07-01T09:42:00Z"
}

Sample Requests

curl https://api.aiaxovio.com/v1/leads/capture \
  -H "Authorization: Bearer aiax_live_xxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"email":"customer@example.com","source":"website_form"}'

fetch("https://api.aiaxovio.com/v1/leads/capture", {
  method: "POST",
  headers: {
    "Authorization": "Bearer aiax_live_xxxxxxxxxxxxxxxx",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({ email: "customer@example.com", source: "website_form" })
});

Rate Limits

Exceeding your limit returns a 429 Too Many Requests response with a Retry-After header.

Error Codes

SDK Examples

Official SDKs are available for Node.js and Python.

npm install @aiaxovio/sdk

import { Aiaxovio } from "@aiaxovio/sdk";
const client = new Aiaxovio("aiax_live_xxxxxxxxxxxxxxxx");
await client.leads.capture({ email: "customer@example.com" });

pip install aiaxovio

from aiaxovio import Client
client = Client("aiax_live_xxxxxxxxxxxxxxxx")
client.leads.capture(email="customer@example.com")