# Manage Signals webhooks

Canonical page: https://docs.ovok.com/cli/reference/webhooks

{/* Written by pnpm docs:generate from the command's spec. Edit the spec, not this page. */}

```bash
ovok webhooks <action> [id] [options]
```

Signals routes need a manager app.

## Options [#options]

| Option | Type | Default | Description |
| --- | --- | --- | --- |
| `--url <url>` | string |  | The URL Signals posts to; create needs it |
| `--event <type>` | string, repeatable | `alert.*` | An event type to send; repeat it for more |
| `--name <name>` | string | `ovok webhooks create` | The webhook's name |
| `--reach all\|attached` | string | `all` | All residents, or only those attached to the webhook |
| `--profile <name>` | string | `default` | The saved profile to use |

## Actions [#actions]

- `list`: Lists the Signals webhooks
- `create`: Creates one and prints its signing secret once
- `delete <id>`: Deletes one
- `test <id>`: Sends a test event and prints the answer
- `rotate-secret <id>`: Prints a new signing secret once
- `enable <id>`: Resumes deliveries
- `disable <id>`: Pauses deliveries

## Examples [#examples]

```bash
ovok webhooks list
ovok webhooks create --url https://example.com/signals --event alert.triggered
ovok webhooks test <id>
```
