POST /v1/webhooks · API Reference

Request headers · 1

Authentication.

Authorizationstringrequired

Production API key. Pass it as Bearer ax_live_…

Request body · 2

JSON request body fields.

urlstringrequired

eventsstring[]required

Returns · 200

The standard { data, meta } envelope. data contains WebhookCreateOut.

Envelope

dataWebhookCreateOut

A single result object.

metaMeta

Pagination and request metadata, including request_id, data_as_of, and ontology_version.

ontology_version 2.1.0replay meta.as_of · ?as_of=<token>

WebhookCreateOut

idinteger

Webhook ID.

urlstring

HTTPS URL that receives webhook deliveries.

eventsstring[]

Subscribed event types (e.g. ['new_filing', 'amendment']).

activeboolean

Whether the webhook is currently active.

created_atstring

When the webhook was created (ISO 8601).

secretstring

HMAC-SHA256 signing secret (64 hex chars). Shown once.

Errors

Standard HTTP status codes plus a typed error.code in the { error: { code, message } } envelope.

Every endpoint returns the same typed error envelope ({ error: { code, message } }). For the full list of codes, see the Errors reference.

RequestcURL

curl -X POST "https://api.axiora.dev/v1/webhooks" \
  -H "Authorization: Bearer ax_live_…" \
  -H "Content-Type: application/json" \
  -d '{ "url": "…", "events": [] }'

Response · 200

200 OK

{
  "data": {
    "id": 0,
    "url": "…",
    "events": [],
    "active": true,
    "created_at": "…",
    "secret": "…"
  },
  "meta": {
    "request_id": "req_abc123",
    "data_as_of": "2026-05-12T03:25:11Z",
    "ontology_version": "2.1.0",
    "as_of": "frz_01HRX9KQ2T8N7P4M"
  }
}

Response · 401

401 UNAUTHORIZED

{
  "error": {
    "code": "UNAUTHORIZED",
    "message": "Missing or invalid API key. Pass it as `Authorization: Bearer ax_live_…`."
  }
}