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
| Channel | Use Case |
|---|
| Email | SMTP-based alerts to team inboxes |
| Slack | Rich-formatted messages in Slack channels |
| ClickUp | Create tasks or send chat messages |
| Twilio | SMS or WhatsApp messages |
| Webhook | HTTP 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.).
| Field | Example |
|---|
| SMTP Host | email-smtp.us-east-1.amazonaws.com |
| SMTP Port | 587 (TLS) or 465 (SSL) |
| Username | Your SMTP username |
| Password | Your SMTP password |
| From Email | alerts@yourdomain.com |
| To Emails | Comma-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
- Go to api.slack.com/apps and create an app
- Enable Incoming Webhooks
- Add a webhook to your target channel
- Copy the webhook URL
Configuration
| Field | Required | Description |
|---|
| Webhook URL | Yes | https://hooks.slack.com/services/T.../B.../xxx |
| Channel | No | Override channel (e.g., #alerts) |
| Username | No | Bot display name (default: Upmetr) |
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
- Go to ClickUp Settings > Apps
- Generate an API Token (starts with
pk_...)
- 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.
| Field | Description |
|---|
| API Token | pk_... |
| List ID | Target list for new tasks |
| Priority | 1=Urgent, 2=High, 3=Normal, 4=Low |
| Assignee ID | Optional — auto-assign to a team member |
Chat Mode
Sends messages to a ClickUp chat channel.
| Field | Description |
|---|
| API Token | pk_... |
| Workspace ID | Your workspace ID |
| Channel ID | Target chat channel |
Twilio (SMS/WhatsApp)
Setup
- Go to console.twilio.com
- Copy your Account SID and Auth Token
- Get or provision a phone number
Configuration
| Field | Description |
|---|
| Account SID | ACxxxxxxxx... |
| Auth Token | Your auth token |
| From Number | Twilio number in E.164 format (+15551234567) |
| To Numbers | Recipient numbers in E.164 format |
| Use WhatsApp | Toggle 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
| Field | Description |
|---|
| URL | Target endpoint |
| Method | POST (default), GET, PUT |
| Auth Type | none, basic, bearer, or api_key |
| Auth Value | Token or credentials |
| Headers | Custom headers (JSON) |
| Payload Template | Custom JSON body |
| Timeout | Request 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
- Go to Settings > Integrations
- Click Add Rule
- Configure:
| Field | Description |
|---|
| Name | Rule name |
| Trigger Type | What event triggers the notification |
| Severity Filter | Minimum severity to match |
| Channels | Which channels to send to |
| Cooldown | Minimum time between repeated notifications |
Trigger Types
| Trigger | Description |
|---|
| Monitor Down | Website/API is down |
| Monitor Up | Website/API recovered |
| Monitor Degraded | Slow response detected |
| SSL Expiring | Certificate expiring soon |
| Budget Threshold | Budget limit approaching |
| Budget Exceeded | Budget limit exceeded |
| Agent Offline | Infrastructure 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
| Issue | Solution |
|---|
| Not receiving notifications | Check the channel configuration and test it. Verify notification rules match the trigger type and severity. |
| Duplicate notifications | Increase the cooldown period on the notification rule. |
| Slack 404 error | Webhook URL may be invalid or revoked. Regenerate in Slack. |
| SMTP auth failed | Verify SMTP credentials (not IAM credentials for AWS SES). |
| Webhook timeout | Increase the timeout or check the target endpoint is reachable. |