juicebox-webhooks-events

# Juicebox Webhooks & Events ## Overview Juicebox delivers webhook notifications for AI-powered people search and analysis workflows. Subscribe to events for completed analyses, updated datasets, ready exports, and quota warnings to build automated pipelines that react to Juicebox intelligence in real time without polling the API. ## Webhook Registration ```typescript const response = await fetch("https://api.juicebox.ai/v1/webhooks", { method: "POST", headers: { "Authorization": `Bearer ${process.env.JUICEBOX_API_KEY}`, "Content-Type": "application/json", }, body: JSON.stringify({ url: "https://yourapp.com/webhooks/juicebox", events: ["analysis.completed", "dataset.updated", "export.ready", "quota.warning"], secret: process.env.JUICEBOX_WEBHOOK_SECRET, }), }); ``` ## Signature Verification ```typescript import crypto from "crypto"; import { Request, Response, NextFunction } from "express"; function verifyJuiceboxSignature(req: Request, res: Response, next: NextFunction) { const signature = req.headers["x-juicebox-signature"] as string; const expected = crypto.createHmac("sha256", process.env.JUICEBOX_WEBHOOK_SECRET!) .update(req.body).digest("hex"); if (!crypto.timingSafeEqual(Buffer.from(signature), Buffer.from(expected))) { return res.status(401).json({ error: "Invalid signature" }); } next(); } ``` ## Event Handler ```typescript import express from "express"; const app = express(); app.post("/webhooks/juicebox", expres...