Webhooks
Register webhook endpoints to receive real-time event notifications from Clevername. Subscribe to specific events, test payloads, and monitor delivery status.
What are webhooks?
Webhooks send HTTP POST requests to your server when events happen in Clevername. Instead of polling the API for updates, your application receives real-time notifications as events occur — such as when an agent completes a task, an error is logged, or a review submission is approved.
Available events
- agent.completed — an agent task finished successfully
- agent.error — an agent task failed
- council.approved — a review submission was approved
- council.rejected — a review submission was rejected
- budget.threshold — a scoped token budget reached its configured threshold
- security.alert — a security event was detected
Delivery and retries
Clevername retries failed webhook deliveries up to 3 times with exponential backoff (30 seconds, 2 minutes, 10 minutes). A delivery is considered failed if your endpoint does not return a 2xx status code within 10 seconds.
Open Webhook settings
Go to Settings → Webhooks in the dashboard. You will see a list of registered endpoints or an empty state.
Add a webhook endpoint
Click Add Webhook. Enter the URL of your endpoint (must be HTTPS). Select the events you want to subscribe to.
Copy the signing secret
After creating the webhook, a signing secret is generated. Copy it and store it securely. Your server should use this secret to verify that incoming webhook payloads are genuinely from Clevername.
Send a test payload
Click Test next to your webhook to send a sample payload. Check your server logs to confirm receipt. The test payload mirrors the real event format so you can validate your handler.
Monitor deliveries
Click on any webhook to see its delivery history. Each delivery shows the HTTP status code, response time, and payload sent. Failed deliveries show the error reason and retry schedule.