name: linear-webhooks
description: Manage webhooks - create, listen for events, rotate secrets. Use when setting up integrations or event listeners.
allowed-tools: Bash
Webhooks
# List all webhooks
linear-cli wh list
# Create a webhook
linear-cli wh create https://example.com/hook --events Issue
# Get webhook details
linear-cli wh get WEBHOOK_ID
# Update a webhook
linear-cli wh update WEBHOOK_ID --url https://new-url.com
# Delete a webhook
linear-cli wh delete WEBHOOK_ID --force
# Rotate signing secret
linear-cli wh rotate-secret WEBHOOK_ID
# Listen for events locally (dev/testing)
linear-cli wh listen --port 9000
linear-cli wh listen --port 9000 --secret SIGNING_SECRET
Subcommands
| Command |
Purpose |
list |
List all webhooks |
get |
View webhook details |
create |
Create webhook |
update |
Update webhook |
delete |
Delete webhook |
rotate-secret |
Rotate signing secret |
listen |
Local event listener with HMAC verification |
Flags
| Flag |
Purpose |
--events TYPE |
Event types to subscribe |
--port N |
Local listener port |
--secret KEY |
HMAC signing secret |
--output json |
JSON output |
Exit Codes
0=Success, 1=Error, 2=Not found, 3=Auth error
By