Webhooks

Cloud Only

Webhooks are available in the Cloud version only.

Webhooks let you receive real-time notifications about agent events via HTTP POST requests to your own server.

Setup

1. Go to Dashboard → Webhooks
2. Click Create Webhook
3. Enter your endpoint URL
4. Select events to subscribe to
5. Save

Events

Event	Trigger
agent:generating_started	Agent started generating a response
agent:generating_completed	Agent finished generating
agent:approval_needed	Agent is waiting for approval
agent:error	Agent encountered an error
machine:connected	Machine came online
machine:disconnected	Machine went offline

Payload Format

{
  "event": "agent:generating_completed",
  "timestamp": "2024-01-15T10:30:00Z",
  "data": {
    "machineId": "abc123",
    "ideId": "abc123:ide:cursor_0",
    "agentType": "cursor",
    "model": "claude-4-sonnet"
  },
  "signature": "sha256=..."
}

Signature Verification

Each webhook request includes an X-ADHDev-Signature header. Verify it to ensure the request came from ADHDev.

Retry Policy

Failed deliveries are retried up to 3 times with exponential backoff.

Plan Limits

Plan	Max Webhooks
Free	2
Pro	10
Team	50
Enterprise	Unlimited