Webhooks

Webhook endpoints receive HTTP POST callbacks when events are published to a channel.

Create Endpoint

endpoint = client.webhooks.create_endpoint(
    url="https://your-app.com/webhook",
    channel_id=1,
)
print(endpoint.id, endpoint.url)

List Endpoints

endpoints = client.webhooks.list_endpoints()
for ep in endpoints:
    print(ep.id, ep.url, ep.channel_id)

Delete Endpoint

client.webhooks.delete_endpoint(endpoint_id=1)

Delivery History

deliveries = client.webhooks.get_deliveries(endpoint_id=1)
for d in deliveries:
    print(d.status_code, d.created_at)

Webhook Payload

When an event is published, axonpush sends a POST request to your endpoint with:

{
  "id": 42,
  "identifier": "task.completed",
  "payload": {"result": "success"},
  "agentId": "planner-01",
  "traceId": "tr_abc123",
  "eventType": "agent.end",
  "channelId": 1,
  "createdAt": "2026-03-31T12:00:00.000Z"
}

Your endpoint should return a 2xx status code to acknowledge receipt. Failed deliveries are visible in the dashboard.