Webhooks notify external services when events happen in Claude Board. Get alerts when tasks start, finish, or need review.
Slack
Posts formatted messages to a Slack channel via incoming webhook URL.
Discord
Sends rich embeds to a Discord channel webhook.
Microsoft Teams
Delivers adaptive cards to a Teams channel connector.
Custom
Sends raw JSON payloads to any HTTP endpoint.
Event Filtering
Choose which events trigger the webhook:
| Event | Description |
|---|
task:created | A new task is added |
task:started | Task moves to In Progress |
task:completed | Agent finishes, task enters Testing |
task:approved | Task is approved and moves to Done |
task:changes_requested | Reviewer requests revisions |
For a “notify on completion” setup, subscribe only to task:completed and task:approved.
Each platform receives a tailored payload format:
Slack
Discord
Teams
Custom
Uses Slack Block Kit with task title, status, model, and a link to the board.
Uses Discord embed format with color-coded status, fields for priority and type.
Uses Adaptive Card schema with action buttons.
Raw JSON with all task fields, event type, and timestamp.{
"event": "task:completed",
"task": { "id": 1, "title": "...", "status": "testing" },
"project": { "id": 1, "name": "..." },
"timestamp": "2025-01-15T10:30:00Z"
}
After creating a webhook, click Test to send a sample payload. This verifies your URL and authentication are correct without waiting for a real event.
Setup
Go to project settings → Webhooks
Click “Add Webhook”.
Select platform and enter URL
Paste your webhook URL from Slack, Discord, Teams, or your custom service.
Choose events
Select which events should trigger this webhook.
Test and save
Click Test to verify, then Save.