> ## Documentation Index
> Fetch the complete documentation index at: https://docs.happyuptime.com/llms.txt
> Use this file to discover all available pages before exploring further.

# happy alerts

Manage alert channels.

# happy alerts

```bash
happy alerts list                            # list channels
happy alerts create [flags]                  # create channel
happy alerts delete <id-or-name>
happy alerts test <id-or-name>               # send a test notification
```

## list

```bash
happy alerts list
```

Output: channel name, type, default flag, monitor count.

## create

```bash
# Slack incoming webhook (legacy — prefer the OAuth app)
happy alerts create \
  --name "ops-team" \
  --type slack \
  --webhook-url https://hooks.slack.com/services/...

# Discord webhook
happy alerts create \
  --name "discord-alerts" \
  --type discord \
  --webhook-url https://discord.com/api/webhooks/...

# Generic webhook (with HMAC signing)
happy alerts create \
  --name "pager" \
  --type webhook \
  --url https://my.pagerservice.example/incoming

# Email
happy alerts create \
  --name "ops-email" \
  --type email \
  --email ops@acme.com
```

## test

```bash
happy alerts test ops-team
```

Sends a synthetic alert payload to the channel. Verify Slack/Discord/email receives it.

## Slack OAuth (preferred)

For full bidirectional Slack (ack/resolve buttons, slash commands, on-call @-mentions), install the OAuth app from the dashboard rather than via CLI:

**Dashboard → Integrations → Slack card → Install Slack app**.

This creates a `slack_app` channel automatically. See [Slack integration](/integrations/slack).