Notifications

Configure notification channels to receive alerts when uptime monitors detect outages or recoveries.

Supported channels

Email

Email notifications are sent to addresses configured in your organization's notification preferences.

Slack

Send alerts to a Slack channel using an incoming webhook URL.

Setup:

1. Create a Slack incoming webhook
2. Copy the webhook URL
3. Add it to your notification preferences

Telegram

Send alerts to a Telegram chat using a bot.

Setup:

1. Create a bot with BotFather
2. Get the bot token
3. Add the bot to your group chat
4. Get the chat ID
5. Add both to your notification preferences

Configuring notifications

Dashboard

1. Go to Organization Settings > Notifications
2. Enable the channels you want
3. Enter the required configuration (webhook URLs, tokens, etc.)
4. Save

API

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

# Update 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/T.../B.../...",
      "telegram_bot_token": "123456:ABC-DEF1234...",
      "telegram_chat_id": "-1001234567890"
    }
  }'

What triggers notifications?

Event	Description
Monitor down	An uptime monitor fails its health check
Monitor recovered	A previously down monitor starts responding normally

Alert content

Notifications include:

• Monitor name
• Status change (up → down or down → up)
• Timestamp
• Response details (status code, response time, or error)
• Link to view the monitor in the dashboard