Webhooks

Overview

Webhooks allow you to receive HTTP POST requests when specific events occur:

• Integrate with external systems
• Trigger automations
• Sync data with other tools

Setting Up Webhooks

1. Go to Workspace Settings → Integrations → Webhooks
2. Click "Add Webhook"
3. Enter your endpoint URL
4. Select events to subscribe to
5. Save and test the webhook

Webhook Payload

Each webhook request includes:

{
  "event": "workitem.updated",
  "timestamp": "2024-01-15T10:30:00Z",
  "workspace_id": "ws_abc123",
  "project_id": "proj_xyz789",
  "data": {
    "id": "wi_123",
    "title": "Fix login bug",
    "status": "done",
    "updated_by": "user_456"
  }
}

Security

Verify webhook authenticity:

• Each webhook includes a signature header
• Verify using your webhook secret
• Reject requests with invalid signatures