Skip to main content
Slack, Discord, and Microsoft Teams alerts all work through incoming webhook URLs. You generate a webhook URL in the destination service, then register it with Overwatch as an alert channel. When a monitor changes state, Overwatch sends a message to that URL and your team sees it immediately in the relevant channel or space.

Get a Slack webhook URL

1

Create a Slack app

Go to api.slack.com/apps and click Create New App. Choose From scratch, give your app a name (e.g. “Overwatch”), and select the workspace you want to post to.
2

Enable incoming webhooks

In your app settings, click Incoming Webhooks in the left sidebar and toggle Activate Incoming Webhooks to on.
3

Add a webhook to your workspace

Scroll down and click Add New Webhook to Workspace. Choose the channel where alerts should appear and click Allow. Copy the webhook URL — it starts with https://hooks.slack.com/services/.

Create the alert channel

curl -X POST https://overwatchapp.dev/api/v1/alerts \
  -H "Authorization: Bearer ow_live_sk_<secret>" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Engineering Slack",
    "type": "SLACK",
    "config": {
      "webhookUrl": "https://hooks.slack.com/services/T00000000/B00000000/XXXXXXXXXXXXXXXXXXXXXXXX"
    }
  }'

Config fields

config.webhookUrl
string
required
The incoming webhook URL from your Slack app settings. Must start with https://hooks.slack.com/services/.

Enabling and disabling a channel

You can pause a channel without deleting it by setting enabled to false. This prevents the channel from firing while keeping its configuration and monitor bindings intact.
# Disable a channel
curl -X PATCH https://overwatchapp.dev/api/v1/alerts/<channel-id> \
  -H "Authorization: Bearer ow_live_sk_<secret>" \
  -H "Content-Type: application/json" \
  -d '{ "enabled": false }'

# Re-enable a channel
curl -X PATCH https://overwatchapp.dev/api/v1/alerts/<channel-id> \
  -H "Authorization: Bearer ow_live_sk_<secret>" \
  -H "Content-Type: application/json" \
  -d '{ "enabled": true }'
A successful response returns the updated channel object with the new enabled value.
Disabling a channel is useful during scheduled maintenance windows when you want to silence notifications without removing the channel configuration.

Coming soon

PagerDuty and SMS are not yet supported as alert channel types. They appear as “coming soon” in the integrations list and will be added in a future release. Check overwatchapp.dev for updates.