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.