Developer APIWebhooks

Webhooks

Register HTTPS endpoints to receive signed JSON events. Deliveries retry with exponential backoff; inspect and replay attempts through the deliveries API.

Supported events

  • widget.created
  • public_api.key.created
  • public_api.key.revoked
  • alert.triggered
  • billing.subscription.updated
  • news.story.corrected
  • news.story.disputed
  • news.story.expired
  • news.story.retracted
  • news.story.removed

Create an endpoint

bash
curl -s http://localhost:4000/v1/webhooks/endpoints \
  -H "Content-Type: application/json" \
  -H "Cookie: session=..." \
  -d '{
    "id": "hooks-main",
    "accountId": "demo-account",
    "name": "Partner hook",
    "url": "https://example.com/hooks/charting",
    "events": ["alert.triggered", "widget.created"],
    "secret": "whsec_your_secret"
  }'

Payload shape

json
{
  "id": "evt_123",
  "type": "alert.triggered",
  "createdAt": "2026-07-09T12:00:00.000Z",
  "data": { "alertId": "alert-1", "symbolId": "NASDAQ:AAPL" }
}

Requests include an HMAC signature header derived from your endpoint secret. Verify it before processing.

Webhooks