Webhooks
Receive real-time notifications about your agents.
You can configure webhooks to receive payloads via HTTP POST whenever specific events occur within your projects.
Event Types
agent.deployed: Triggered when an agent successfully starts running.agent.crashed: Triggered if an agent container exits unexpectedly.agent.stopped: Triggered when an agent is manually stopped.
Payload Structure
JSON Payload
{
"event": "agent.deployed",
"timestamp": "2026-02-14T12:34:56Z",
"data": {
"projectId": "proj_123abc",
"projectName": "My Trading Bot",
"status": "running",
"ip": "10.0.0.5"
}
}Security Note
Verify the X-Clawn-Signature header to ensure the webhook request originated from us.