Integration
Real-time event notifications via HTTP
Receive real-time HTTP callbacks when Zesuss publishes content. Webhooks deliver signed JSON payloads to your endpoint so you can build custom workflows, sync content to internal tools, or trigger downstream automation — all with Standard Webhooks compliant signing.
Best for: Custom workflows, internal tooling, and real-time content syncingBuild or use an HTTP server that accepts POST requests with JSON bodies. Your endpoint must return a 2xx status to confirm receipt.
Inside your Zesuss Dashboard → Webhooks, click 'Add Webhook'. Enter your endpoint URL and select which events to subscribe to (article.published, article.updated, article.deleted).
After creation, copy the Integration Key (whk_...) and Secret (whsec_...). The secret is shown once — store it securely. Use the secret to verify incoming payload signatures on your end.
// Example: Receive and verify a Zesuss webhook
import express from 'express';
import { Webhook } from 'standardwebhooks';
const app = express();
app.use(express.json());
// Your webhook secret from the dashboard
const webhookSecret = 'whsec_your_secret_here';
app.post('/webhooks/zesuss', (req, res) => {
const wh = new Webhook(webhookSecret);
try {
// Verify the signed payload
const payload = wh.verify(
JSON.stringify(req.body),
req.headers
);
console.log('Event:', payload.event);
console.log('Title:', payload.title);
console.log('Post URL:', payload.post_url);
// Handle the event
if (payload.event === 'article.published') {
// Sync to your CMS, send Slack notification, etc.
}
res.status(200).json({ received: true });
} catch (err) {
console.error('Invalid signature:', err.message);
res.status(401).json({ error: 'Invalid signature' });
}
});
app.listen(3001);Every webhook delivers a standardized JSON payload with the full article metadata. The payload is signed using the Standard Webhooks specification — verify the signature on your end before processing.
Zesuss AI
Just now
Monitor every webhook delivery Zesuss sends to your endpoints. Track delivery success rates, response times, and payload contents to ensure your integrations are running smoothly.
Always verify the webhook signature using the Standard Webhooks library before processing the payload
Return a 2xx status quickly (< 5s) to avoid timeout retries — process the payload asynchronously
Use the webhook-id header for idempotent processing and deduplication
Rotate your webhook secret periodically via the regenerate feature in the dashboard