Slack Integration

Receive real-time MaxRMM alert notifications in your Slack channels.

Overview

The Slack integration sends formatted messages to a Slack channel when alerts fire, agents go offline, or other events occur. It uses Slack's Incoming Webhooks — no Slack app installation or OAuth flow required.

Step 1: Create a Slack Webhook

1. Go to api.slack.com/messaging/webhooks
2. Click "Create your Slack app" (or select an existing app)
3. Select the workspace you want to send notifications to
4. Under Features → Incoming Webhooks, toggle webhooks On
5. Click "Add New Webhook to Workspace"
6. Select the channel (e.g., #alerts or #maxrmm-alerts)
7. Copy the webhook URL — it looks like:
   https://hooks.slack.com/services/T00000000/B00000000/XXXXXXXXXXXXXXXXXXXXXXXX

Step 2: Configure in MaxRMM

In the MaxRMM dashboard, go to Settings → Integrations and add the Slack integration:

Via the Dashboard

1. Click Add Integration
2. Select Slack
3. Paste the webhook URL
4. Click Save

Via the API

POST /api/integration-config
Content-Type: application/json
Authorization: Bearer <access-token>

{
  "slug": "slack",
  "config": {
    "webhookUrl": "https://hooks.slack.com/services/T00000000/B00000000/XXXXXXXXXXXXXXXXXXXXXXXX"
  }
}

Step 3: Test the Integration

After saving, click Test (or use the API) to send a test notification:

POST /api/integration-config/:id/test
Authorization: Bearer <access-token>

You should see a message in your Slack channel that says "Test notification from MaxRMM" with a test agent hostname.

What Gets Notified

By default, the Slack integration sends notifications for:

• Alert fired — When a new alert is created (includes severity, category, hostname, and alert title)
• Alert resolved — When an alert is resolved
• Agent offline — When an agent stops reporting

Slack Message Format

Alert notifications are formatted with color-coded severity:

• Red — Critical alerts
• Yellow — Warning alerts
• Blue — Info alerts

Each message includes:

• Alert severity and title
• Agent hostname
• Alert category (cpu, ram, disk, av, service, offline)
• Timestamp

Managing the Integration

Disable temporarily

PUT /api/integration-config/:id
{
  "enabled": false
}

Update webhook URL

PUT /api/integration-config/:id
{
  "config": {
    "webhookUrl": "https://hooks.slack.com/services/NEW-WEBHOOK-URL"
  }
}

Remove the integration

DELETE /api/integration-config/:id