Event Delivery

Webhooks

Receive real-time notifications when events occur in AEXO. Subscribe to dataset updates, exports, and account changes without polling.

Developer Preview — Webhook delivery coming Q3 2026

Webhooks are currently in active development. This documentation describes the planned API surface. Early access is available for enterprise partners.

Overview

Webhooks allow your application to receive real-time notifications when events occur in AEXO. Instead of polling the API, your registered endpoint receives HTTP POST requests automatically when dataset or account events are triggered.

Supported Events

Event	Trigger	Payload Size
dataset.refreshed	Dataset records updated in monthly cycle	~2KB
export.completed	Bulk export file ready for download	~1KB
key.created	New API key generated for account	~500B
key.revoked	API key deactivated	~500B
record.flagged	Individual record marked for review	~3KB

Payload Structure

Every webhook event includes a structured JSON payload with event metadata and contextual data.

{
  "id": "wh_01HXYZ123456789",
  "event": "dataset.refreshed",
  "created_at": "2026-05-17T08:30:00Z",
  "api_version": "1.3.0",
  "data": {
    "dataset_name": "ny-verified-contractors",
    "records_updated": 847,
    "records_added": 203,
    "records_removed": 12,
    "refresh_cycle": "monthly"
  }
}

Signature Verification

Every webhook request includes an X-AEXO-Signature header. Verify this signature to confirm the request originated from AEXO.

const crypto = require('crypto');

function verifyWebhook(payload, signature, secret) {
  const expected = crypto
    .createHmac('sha256', secret)
    .update(JSON.stringify(payload))
    .digest('hex');
  return crypto.timingSafeEqual(
    Buffer.from(signature),
    Buffer.from(expected)
  );
}

Retry Logic

If a webhook delivery fails, AEXO automatically retries with exponential backoff. After 4 failed attempts, the webhook is disabled.

Attempt 1

Immediate

Attempt 2

5 minutes after failure

Attempt 3

30 minutes after failure

Attempt 4

2 hours after failure

Webhook Disabled

After 4 failures, webhook is disabled and notification sent to registered email

Register Endpoint

Coming Soon

Webhook registration endpoints are coming in API v1.4.0. This will allow you to:

→Register webhook URLs to receive events
→Filter events by type
→Manage webhook secrets and rotation
→Test webhook deliveries from dashboard

Request Early Webhook Access