# ry webhooks

> Endpoints we call when a message is sent, bounces, is complained about, fails or arrives.

```text
ry webhooks [options] [command]
```

## Subcommands

### `ry webhooks list`

Your webhooks with the answer of their last delivery.

```text
ry webhooks list [options]
```

Example:

```bash
ry webhooks list
```

### `ry webhooks add`

Register an https endpoint; prints the signing secret exactly once.

```text
ry webhooks add [options] <url>
```

Options:

- `-e, --events <list>`: Comma-separated events (sent, delivered, delivery_delayed, bounced, complained, failed, received), or all. Default: `all`.

Example:

```bash
ry webhooks add https://www.example.com/hooks/rytiv
```

### `ry webhooks deliveries`

The last deliveries to one endpoint, newest first.

```text
ry webhooks deliveries [options] <id>
```

Options:

- `-n, --limit <n>`: How many entries (control plane caps at 500). Default: `50`.

Example:

```bash
ry webhooks deliveries wh-1a2b3c4d
```

### `ry webhooks remove`

Delete a webhook; pending deliveries are dropped.

```text
ry webhooks remove [options] <id>
```

Options:

- `-y, --yes`: Skip confirmation (required for automation).

Example:

```bash
ry webhooks remove wh-1a2b3c4d
```