Webhooks API
Webhooks are planned, not yet shipped. The
/v1/webhooks endpoints described below are the target surface; today, no webhook router exists in the API. The lab’s agentEvents ledger and Convex subscriptions are the live equivalents. Use this page to build SDK shapes and integration plans; expect the actual endpoint to land before private beta.Create a Webhook
Event Types
Experiment Events
Agent Events
Task Events
Pod Events
Paper Events
Knowledge Events
Payload Format
All webhook payloads follow a consistent structure:Signature Verification
Every webhook request includes anX-Hubify-Signature header containing an HMAC-SHA256 signature of the raw request body, computed using your webhook secret.
Retry Policy
Failed webhook deliveries are retried with exponential backoff:
After 6 failed attempts, the webhook is marked as failing and the Captain receives a notification. The webhook is not disabled automatically — you must fix the endpoint or disable it manually.
A delivery is considered failed if:
- The endpoint returns a non-2xx status code
- The request times out after 30 seconds
- The endpoint is unreachable (DNS failure, connection refused)