Alerts & Notifications

Get notified when your monitors detect outages or recoveries. Hooklistener supports multiple notification channels so you never miss a status change.

Notification channels

Email

Alerts are sent to the email addresses configured in your organization's notification preferences.

Slack

Send alerts to a Slack channel:

1. Go to Organization Settings > Notifications
2. Add a Slack webhook URL
3. Alerts are posted as messages to the configured channel

Telegram

Send alerts to a Telegram chat:

1. Go to Organization Settings > Notifications
2. Configure your Telegram bot token and chat ID
3. Alerts are sent as Telegram messages

Configuring notification preferences

From the dashboard:

1. Navigate to Organization Settings > Notifications
2. Enable or disable each notification channel
3. Configure channel-specific settings (webhook URLs, tokens, etc.)
4. Save your preferences

From the API:

# Get current notification preferences
curl https://app.hooklistener.com/api/v1/organizations/<org-id>/notification_preferences \
  -H "Authorization: Bearer hklst_your_api_key"

# Update notification preferences
curl -X PATCH https://app.hooklistener.com/api/v1/organizations/<org-id>/notification_preferences \
  -H "Authorization: Bearer hklst_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "notification_preferences": {
      "email_enabled": true,
      "slack_webhook_url": "https://hooks.slack.com/services/...",
      "telegram_bot_token": "123456:ABC-DEF...",
      "telegram_chat_id": "-1001234567890"
    }
  }'

Alert types

Alert	When it fires
Monitor down	A previously healthy monitor fails its check
Monitor recovered	A previously down monitor starts responding normally

Alert content

Each alert includes:

• Monitor name — which monitor triggered the alert
• Status change — what changed (up → down, down → up)
• Timestamp — when the status change was detected
• Response details — status code, response time, or error message
• Monitor URL — link to view the monitor in the dashboard