Monoduty Documentation

Welcome to Monoduty! This documentation will help you get started with our alerting platform and make the most of its features.

Quick Start

Get your first alert working in under 5 minutes. Follow these simple steps:

curl -X POST https://api.monoduty.com/webhook/YOUR_WEBHOOK_ID \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Test Alert",
    "message": "This is my first Monoduty alert!",
    "severity": "info"
  }'

Core Concepts

Webhooks

A webhook is a unique URL endpoint that accepts HTTP POST requests. When a request is received, Monoduty processes the payload and sends alerts to your configured notification channels.

Notification Channels

Monoduty supports multiple notification channels:

• SMS - Text messages with global delivery
• Email - Rich HTML emails with full context
• Voice Calls - Automated phone calls for critical alerts
• Push Notifications - Mobile app notifications (iOS & Android)

Severity Levels

Webhooks Overview

Monoduty's universal webhook system is designed to work with any tool or service that can make HTTP requests. This means you can integrate with Grafana, Prometheus, custom scripts, CI/CD pipelines, and literally anything else.

Creating Webhooks

You can create webhooks through the Dashboard UI or via the API.

Via Dashboard

1. Navigate to Dashboard → Webhooks
2. Click "Create Webhook"
3. Enter a name and description
4. Select notification channels
5. Configure optional settings (payload template, filters)
6. Click "Create"

Via API

curl -X POST https://api.monoduty.com/v1/webhooks \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Production Alerts",
    "channels": ["sms", "email"],
    "description": "Alerts from production servers"
  }'

Webhook Payload Format

Monoduty accepts JSON payloads with the following fields:

Example Payload

{
  "title": "High CPU Usage on web-server-01",
  "message": "CPU usage exceeded 90% for 5 minutes",
  "severity": "warning",
  "source": "prometheus",
  "tags": {
    "host": "web-server-01",
    "environment": "production"
  },
  "url": "https://grafana.example.com/d/abc123"
}

Webhook Security

Secure your webhooks with these best practices:

Webhook Secrets

Each webhook can have a secret key for signature verification:

# Include HMAC signature in header
curl -X POST https://api.monoduty.com/webhook/YOUR_WEBHOOK_ID \
  -H "Content-Type: application/json" \
  -H "X-Monoduty-Signature: sha256=COMPUTED_SIGNATURE" \
  -d '{"title": "Alert"}'

IP Allowlisting

Restrict webhook access to specific IP addresses in your webhook settings.

Grafana Integration

Connect Grafana alerting to Monoduty in under 2 minutes.

Name: Monoduty Alerts
Type: Webhook
URL: https://api.monoduty.com/webhook/YOUR_WEBHOOK_ID
HTTP Method: POST

Prometheus / Alertmanager

Route Prometheus Alertmanager notifications to Monoduty.

Alertmanager Configuration

Add Monoduty as a webhook receiver in your alertmanager.yml:

receivers:
  - name: 'monoduty'
    webhook_configs:
      - url: 'https://api.monoduty.com/webhook/YOUR_WEBHOOK_ID'
        send_resolved: true

route:
  receiver: 'monoduty'
  group_by: ['alertname', 'severity']
  group_wait: 30s
  group_interval: 5m
  repeat_interval: 4h

Slack Integration

Get real-time alerts in your Slack channels with interactive buttons.

Slack Alert Features

• Rich message formatting with alert details
• Acknowledge button to claim incidents
• Resolve button to close alerts
• Escalate to notify additional team members
• Thread support for incident updates

Discord Integration

Bring incident response into your Discord server.

Telegram Integration

Receive alerts directly in Telegram chats and groups.

AWS CloudWatch

Connect AWS CloudWatch alarms to Monoduty via SNS.

# Create SNS topic
aws sns create-topic --name monoduty-alerts

# Subscribe Monoduty webhook
aws sns subscribe \
  --topic-arn arn:aws:sns:us-east-1:123456789:monoduty-alerts \
  --protocol https \
  --notification-endpoint https://api.monoduty.com/webhook/YOUR_WEBHOOK_ID

Datadog Integration

Forward Datadog monitors and alerts to Monoduty.

Name: Monoduty
URL: https://api.monoduty.com/webhook/YOUR_WEBHOOK_ID

Payload:
{
  "title": "$EVENT_TITLE",
  "message": "$EVENT_MSG",
  "severity": "$ALERT_TYPE",
  "source": "datadog",
  "tags": {
    "host": "$HOSTNAME",
    "alert_id": "$ALERT_ID"
  },
  "url": "$LINK"
}

API Reference

The Monoduty REST API allows you to programmatically manage webhooks, send alerts, and access your data.

Base URL

Response Format

All responses are returned in JSON format:

{
  "success": true,
  "data": { ... },
  "message": "Operation successful"
}

Authentication

All API requests require authentication via API key:

curl https://api.monoduty.com/v1/webhooks \
  -H "Authorization: Bearer YOUR_API_KEY"

Generate API keys in Settings → API Keys.

Webhooks API

List Webhooks

Create Webhook

curl -X POST https://api.monoduty.com/v1/webhooks \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Production Alerts",
    "channels": ["sms", "email"],
    "description": "Critical production alerts"
  }'

Get Webhook

Update Webhook

Delete Webhook

Alerts API

Send Alert (via Webhook)

List Alerts

Query parameters:

Get Alert Details

Acknowledge Alert

Resolve Alert

Users API

Get Current User

Update User Settings

List Team Members

Need Help?

Can't find what you're looking for? We're here to help!