Skip to content
StatusOwlDocs

Slack integration

Post formatted alerts to any Slack channel via an incoming webhook.

Last updated May 9, 2026

The Slack integration uses an incoming webhook — no workspace-wide app install is required. Each webhook posts to a single pre-chosen channel.

Creating the Slack webhook

  1. At api.slack.com/apps, create a new app (or open your existing StatusOwl app) and enable Incoming Webhooks.
  2. Click Add New Webhook to Workspace, pick the target channel, and authorize.
  3. Copy the generated webhook URL — it starts with https://hooks.slack.com/services/.

Connecting it to StatusOwl

  1. Go to Integrations → Add Integration and choose Slack.
  2. Paste the incoming webhook URL.
  3. Enter the channel name (display-only — the actual channel is baked into the webhook).
  4. Choose which events to subscribe to (see event coverage for what currently fires).
  5. Click Save, then Send Test to confirm delivery.

One channel per webhook

A Slack incoming webhook targets a fixed channel chosen at creation time. To route different monitors to different channels, create a separate Slack webhook per channel and add each as its own StatusOwl integration.

What currently sends to this integration

Per the integrations overview, Slack integrations receive:

  • Send Test events fired from the dashboard.
  • Watch Owl alert rules — when a host-metric rule routes to this integration, firing and resolving alerts post to the channel as formatted messages with severity-driven color and rule context.

Uptime-monitor state changes (down / recovery / maintenance) are configured on the integration but not yet dispatched. The flags are ready for the dispatch service when it ships.

Message format

StatusOwl sends a hybrid text + blocks payload so messages render cleanly on both modern and legacy Slack clients. Watch Owl alert messages include the rule name, host, metric and current value, threshold, and a timestamp. Severity-driven color is used for fire (red) and resolve (green).

When uptime-monitor state-change dispatch ships, message format for those events will be documented here.

See also