Skip to main content

Notifications

Upmetr supports 5 notification channels for delivering alerts. Configure channels at Settings > Integrations, then create notification rules to define when each channel fires.

Channels Overview

ChannelUse Case
EmailSMTP-based alerts to team inboxes
SlackRich-formatted messages in Slack channels
ClickUpCreate tasks or send chat messages
TwilioSMS or WhatsApp messages
WebhookHTTP requests to n8n, Zapier, PagerDuty, or any endpoint
All credentials are encrypted at rest using Fernet symmetric encryption.

Email (SMTP)

Send alerts via any SMTP provider (AWS SES, Gmail, SendGrid, etc.).
FieldExample
SMTP Hostemail-smtp.us-east-1.amazonaws.com
SMTP Port587 (TLS) or 465 (SSL)
UsernameYour SMTP username
PasswordYour SMTP password
From Emailalerts@yourdomain.com
To EmailsComma-separated recipient list
For AWS SES: Create SMTP credentials in the SES console (not IAM credentials). The “From Email” must match a verified domain or address in SES.

Slack

Rich-formatted messages with severity-based color coding.

Setup

  1. Go to api.slack.com/apps and create an app
  2. Enable Incoming Webhooks
  3. Add a webhook to your target channel
  4. Copy the webhook URL

Configuration

FieldRequiredDescription
Webhook URLYeshttps://hooks.slack.com/services/T.../B.../xxx
ChannelNoOverride channel (e.g., #alerts)
UsernameNoBot display name (default: Upmetr)

Message Format

Slack messages include:
  • Color bar — Blue (info), Orange (warning), Red (error), Dark red (critical)
  • Title — Alert summary
  • Message — Full details with metadata
  • Custom templates — Use {title}, {message}, {severity} variables

ClickUp

Two modes: create tasks or send chat messages.

Getting Credentials

  1. Go to ClickUp Settings > Apps
  2. Generate an API Token (starts with pk_...)
  3. Find your Workspace ID in the URL: https://app.clickup.com/WORKSPACE_ID/...

Task Mode

Creates a task in a ClickUp list when an alert fires.
FieldDescription
API Tokenpk_...
List IDTarget list for new tasks
Priority1=Urgent, 2=High, 3=Normal, 4=Low
Assignee IDOptional — auto-assign to a team member

Chat Mode

Sends messages to a ClickUp chat channel.
FieldDescription
API Tokenpk_...
Workspace IDYour workspace ID
Channel IDTarget chat channel

Twilio (SMS/WhatsApp)

Setup

  1. Go to console.twilio.com
  2. Copy your Account SID and Auth Token
  3. Get or provision a phone number

Configuration

FieldDescription
Account SIDACxxxxxxxx...
Auth TokenYour auth token
From NumberTwilio number in E.164 format (+15551234567)
To NumbersRecipient numbers in E.164 format
Use WhatsAppToggle for WhatsApp instead of SMS
Phone numbers must be in E.164 format. Examples: US +15551234567, Brazil +5511999999999.

Webhook (Generic HTTP)

Send HTTP requests to any endpoint — perfect for integrating with n8n, Zapier, Make, PagerDuty, or custom systems.

Configuration

FieldDescription
URLTarget endpoint
MethodPOST (default), GET, PUT
Auth Typenone, basic, bearer, or api_key
Auth ValueToken or credentials
HeadersCustom headers (JSON)
Payload TemplateCustom JSON body
TimeoutRequest timeout (default: 30s)

Default Payload

If no custom template is set:
{
  "event": "upmetr_alert",
  "timestamp": "2026-03-31T15:30:00Z",
  "title": "Alert Title",
  "message": "Alert details",
  "severity": "critical",
  "details": { }
}

Notification Rules

After configuring channels, create rules to define when and where alerts are sent.

Creating a Rule

  1. Go to Settings > Integrations
  2. Click Add Rule
  3. Configure:
FieldDescription
NameRule name
Trigger TypeWhat event triggers the notification
Severity FilterMinimum severity to match
ChannelsWhich channels to send to
CooldownMinimum time between repeated notifications

Trigger Types

TriggerDescription
Monitor DownWebsite/API is down
Monitor UpWebsite/API recovered
Monitor DegradedSlow response detected
SSL ExpiringCertificate expiring soon
Budget ThresholdBudget limit approaching
Budget ExceededBudget limit exceeded
Agent OfflineInfrastructure agent stopped reporting

Testing Channels

Each channel has a Test button that sends a test notification. Always verify channels work before relying on them for production alerts.

Notification Preferences

Users can customize their personal notification preferences at Account > Notifications:
  • Severity filter — Only receive alerts above a certain severity
  • Trigger filter — Only receive specific trigger types
  • Quiet hours — Suppress notifications during off hours

Troubleshooting

IssueSolution
Not receiving notificationsCheck the channel configuration and test it. Verify notification rules match the trigger type and severity.
Duplicate notificationsIncrease the cooldown period on the notification rule.
Slack 404 errorWebhook URL may be invalid or revoked. Regenerate in Slack.
SMTP auth failedVerify SMTP credentials (not IAM credentials for AWS SES).
Webhook timeoutIncrease the timeout or check the target endpoint is reachable.