Webhooks

curl -X POST https://{project}.polpo.cloud/v1/webhooks \
  -H "Authorization: Bearer $POLPO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com/polpo","events":["task:*"]}'

{
  "ok": true,
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "url": "https://example.com/polpo",
    "events": ["task:*"],
    "secret": "7f42b5..."
  }
}

{
  "event": "task:transition",
  "data": {"taskId":"task_123","from":"in_progress","to":"done"},
  "timestamp": "2026-07-13T10:05:00.000Z"
}

X-Polpo-Signature: t=1783937100,v1=<hex-hmac>
X-Polpo-Event: task:transition
X-Polpo-Delivery-Id: <uuid>