Integrations

Slack alerts

Pipe incident notifications directly into the Slack channels where your team collaborates. Uptime sends rich Block Kit messages via Slack’s incoming webhook API, so every outage is announced with context and links back to the monitor dashboard.

← Docs home Manage alert channels

Prerequisites

  • An Uptime plan that permits Slack alert channels.
  • Slack workspace permissions to create an app or incoming webhook.
  • At least one monitor configured in xUptimeMonitor.

Create the Slack webhook URL

  1. In Slack, visit api.slack.com/apps and click Create New App. Choose From scratch, give it a recognizable name (for example “Uptime alerts”), and pick the workspace that should receive notifications.
  2. Open the app configuration and enable the Incoming Webhooks feature.
  3. Scroll to the bottom of the page and press Add New Webhook to Workspace. Select the channel that should receive alerts and authorize the app.
  4. Copy the webhook URL Slack generates. It starts with https://hooks.slack.com/services/. Keep it handy for the next step.

Add the Slack channel in Uptime

  1. Navigate to Dash → Alerts → Channels and click New channel.
  2. Select Slack as the type and provide an optional name like “On-call Slack”.
  3. Paste the webhook URL you copied from Slack.
  4. Choose a Visibility setting:
    • Private — includes IP addresses and other sensitive metadata in the alert.
    • Public — redacts sensitive fields so you can post to shared channels or communities.
  5. Optionally adjust delivery thresholds (delay and required offline regions) if your plan allows custom notify rules.
  6. Save the channel and attach it to the monitors or monitor groups that should broadcast to Slack.

Customize the message template

Slack alerts support the same templating engine used by other channels. The rendered string becomes the headline of the Block Kit card, while additional fields (monitor, agent, duration, links) are filled in automatically.

Common placeholders include:

  • {monitorName} — display the monitor label.
  • {status} — current status (DOWN or UP).
  • {incidentDuration} — human-friendly downtime length.
  • {extraDetails} — additional context, redacted for public channels.

Templates are optional. If you leave the field blank, Uptime sends a default :rotating_light: alert with the monitor, agent, and dashboard link.

Testing & best practices

  • Use the Send test button in Dash → Alerts → Channels to post an example payload to Slack.
  • Start with a private channel to review formatting before sharing alerts more broadly.
  • Rotate the webhook URL in Slack if a token is ever exposed, then update the channel configuration in Uptime.
  • Combine Slack alerts with maintenance windows to avoid noisy notifications during planned downtime.

Removing the connection

Detach the Slack channel from all monitors or delete it from the Alert Channels page to stop future messages. You can also disable or remove the incoming webhook inside Slack for an immediate cutoff.