> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://platform.bctrl.ai/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://platform.bctrl.ai/_mcp/server.

# Webhook Commands

> Manage signed webhooks and inspect or redeliver their deliveries.

Manage signed webhooks and inspect or redeliver their deliveries.

Output formatting flags (`--json`, `--jq`, and `--template`) are documented once in [Output Formatting](/cli/output) and are omitted from the tables below.

## `bctrl webhook list`

List webhooks

```bash
bctrl webhook list [flags]
```

| Flag                   | Description                         |
| ---------------------- | ----------------------------------- |
| `-L, --limit <number>` | Maximum number of results to return |
| `--cursor <cursor>`    | Pagination cursor                   |

## `bctrl webhook create`

Create a webhook (the signing secret is returned once)

```bash
bctrl webhook create
```

## `bctrl webhook get`

Get a webhook

```bash
bctrl webhook get <webhookId>
```

## `bctrl webhook patch`

Update a webhook

```bash
bctrl webhook patch <webhookId>
```

## `bctrl webhook delete`

Delete a webhook

```bash
bctrl webhook delete <webhookId> [flags]
```

| Flag        | Description      |
| ----------- | ---------------- |
| `-y, --yes` | Confirm deletion |

## `bctrl webhook rotate-secret`

Rotate a webhook signing secret

```bash
bctrl webhook rotate-secret <webhookId>
```

## `bctrl webhook test`

Queue a test delivery

```bash
bctrl webhook test <webhookId>
```

## `bctrl webhook deliveries list`

List webhook deliveries

```bash
bctrl webhook deliveries list <webhookId> [flags]
```

| Flag                   | Description                         |
| ---------------------- | ----------------------------------- |
| `-L, --limit <number>` | Maximum number of results to return |
| `--cursor <cursor>`    | Pagination cursor                   |

## `bctrl webhook deliveries redeliver`

Queue a webhook delivery again

```bash
bctrl webhook deliveries redeliver <webhookId> <deliveryId>
```