# Linear Webhooks

> Manage webhooks - create, listen for events, rotate secrets. Use when setting up integrations or event listeners.

- Skill: `finesssee/linear-webhooks` (Agent Skill)
- Install (CLI): `npx skillmds@latest add finesssee/linear-webhooks`
- Raw SKILL.md: https://api.skillmd.com/api/skills/finesssee/linear-webhooks/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: Finesssee (https://skillmd.com/u/finesssee)
- Updated: 2026-09-10
- Page: https://skillmd.com/skills/finesssee/linear-webhooks

---


# Webhooks

```bash
# 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