Zikit + Custom Webhooks

Payload shape

On every meaningful change (above your importance threshold), Zikit sends onePOST withContent-Type: application/json:

{
  "event": "change_detected",
  "monitor": {
    "name": "Competitor Pricing - OpenAI",
    "url": "https://openai.com/chatgpt/pricing"
  },
  "change": {
    "summary": "ChatGPT Plus moved from $20/mo flat to $20/mo + usage credits. New Business tier at $25/user/mo.",
    "importance": 8,
    "changeType": "content"
  },
  "timestamp": "2026-04-23T14:41:00.000Z",
  "source": "zikit.ai"
}

• event - currently always change_detected. New event types will land as additive values.
• monitor.name / monitor.url - the page that changed.
• change.summary - plain-English AI summary (same text that appears in your dashboard).
• change.importance - integer 1-10. Zikit only POSTs changes at or above your configured threshold.
• change.changeType - content, price, status, etc.
• timestamp - ISO 8601 UTC, when the change was detected.

Example handlers

Node / Express

// Example: Express handler
import express from "express";
const app = express();
app.use(express.json());

app.post("/zikit-hook", (req, res) => {
  const { monitor, change } = req.body;
  if (change.importance >= 7) {
    // route high-severity changes to on-call
    notifyOnCall(`${monitor.name}: ${change.summary}`);
  }
  res.status(200).end();
});

app.listen(3000);

Python / FastAPI

# Example: FastAPI handler
from fastapi import FastAPI, Request

app = FastAPI()

@app.post("/zikit-hook")
async def zikit(req: Request):
    payload = await req.json()
    monitor = payload["monitor"]
    change = payload["change"]
    if change["importance"] >= 7:
        notify_on_call(f"{monitor['name']}: {change['summary']}")
    return {"ok": True}

Reply with any 2xx status to acknowledge. If your endpoint returns non-2xx or times out after 10 seconds, Zikit logs the failure and marks the alert for review - it does not retry automatically (by design, to avoid duplicate-event hell).

Setup

Requirements & limits

• Zikit Business plan ($49/mo) - Webhooks are a Business-tier feature
• HTTPS endpoint with a valid TLS certificate (self-signed not supported)
• Endpoint must respond with a 2xx status within 10 seconds
• One POST per meaningful change - no retries, no ordering guarantee between monitors
• SSRF protection blocks private IPs, loopback, link-local, and non-HTTPS URLs

FAQ