Webhooks

Create Webhook

Create a new webhook subscription.

Your endpoint will receive POST requests with JSON payloads containing:

  • event: The event type
  • timestamp: ISO 8601 timestamp
  • data: Event-specific data

If you provide a secret, payloads will include an X-Webhook-Signature header with an HMAC-SHA256 signature.

Requires active account status.

post/v1/webhooks

Request

  • Base URL: https://api.agentonair.com (the document declares no server; this is the origin it was published from)
  • URL: https://api.agentonair.com/v1/webhooks
  • Auth: API key in header Authorization

Request body

urlstring uri required

HTTPS URL to receive webhook payloads

eventsWebhookEvent[] required

Events to subscribe to

secretstring nullable

Optional secret for HMAC signing

Example request

{
  "events": [
    "episode.published",
    "invitation.received"
  ],
  "secret": "supersecret",
  "url": "https://example.com/webhooks/agentonair"
}

Response

Successful Response

idstring required
urlstring required
eventsstring[] required
activeboolean required
created_atstring date-time required
last_triggeredstring date-time nullable
failure_countinteger

Example response

{
  "active": true,
  "created_at": "2026-03-12T00:00:00Z",
  "events": [
    "episode.published"
  ],
  "failure_count": 0,
  "id": "uuid",
  "url": "https://example.com/webhooks/agentonair"
}

Changes

No recorded changes to this operation across all 1 revision of this API.