---
title: "Alerts and channels commands"
description: "Rules that decide what you hear about, and the channels it lands in."
canonical: https://docs.mentio.dev/cli/alerts
markdown: https://docs.mentio.dev/cli/alerts.mdx
---

# Alerts and channels commands

Rules that decide what you hear about, and the channels it lands in.

Rules that decide what you hear about, and the channels it lands in. Generated from the same OpenAPI document as the [API Reference](/api); ids are positional, every other input is a flag named as in the API, and each flag is described there. Global flags: `--api-key`, `--api-url`, `--pretty`, `--table`.

```bash
mentio channels:create --kind webhook --url https://example.com/hooks/mentio --label Production
mentio alerts:create --name "Negative mentions" --event mention.negative --filter '{"sentiments":["negative"]}' --channelIds dest_...
mentio alerts:create --name "Week in review" --mode weekly --schedule '{"hour":9,"minute":0,"timezone":"Europe/Madrid","weekday":1}' --channelIds dest_...
mentio alerts:test feed_...
mentio channels:deliveries dest_...
```

| Command                              | What it does                            | Flags                                                                                           |
| ------------------------------------ | --------------------------------------- | ----------------------------------------------------------------------------------------------- |
| `mentio alerts:create`               | Create an alert                         | `--name`, `--enabled`, `--mode`, `--filter`, `--schedule`, `--event`, `--channelIds`, `--json`  |
| `mentio alerts:delete <id>`          | Delete an alert                         |                                                                                                 |
| `mentio alerts:get <id>`             | Get an alert                            |                                                                                                 |
| `mentio alerts:list`                 | List alerts                             |                                                                                                 |
| `mentio alerts:mute <id>`            | Mute authors on an alert                | `--authors`, `--json`                                                                           |
| `mentio alerts:run <id>`             | Send a digest now                       |                                                                                                 |
| `mentio alerts:test <id>`            | Send a test through an alert's channels |                                                                                                 |
| `mentio alerts:unmute <id>`          | Unmute authors on an alert              | `--authors`, `--json`                                                                           |
| `mentio alerts:update <id>`          | Update an alert                         | `--name`, `--enabled`, `--mode`, `--filter`, `--schedule`, `--event`, `--channelIds`, `--json`  |
| `mentio channels:create`             | Create a channel                        | `--kind`, `--channelId`, `--channelName`, `--emails`, `--url`, `--label`, `--headers`, `--json` |
| `mentio channels:delete <id>`        | Delete a channel                        |                                                                                                 |
| `mentio channels:deliveries <id>`    | List deliveries to a channel            | `--limit`                                                                                       |
| `mentio channels:get <id>`           | Get a channel                           |                                                                                                 |
| `mentio channels:list`               | List channels                           |                                                                                                 |
| `mentio channels:rotate-secret <id>` | Rotate a webhook secret                 |                                                                                                 |
| `mentio channels:test <id>`          | Send a test to a channel                |                                                                                                 |
| `mentio channels:update <id>`        | Update a channel                        | `--label`, `--url`, `--headers`, `--json`                                                       |