Skip to main content
Connect DevHelm to Slack to receive incident notifications in your channels. DevHelm uses Slack’s Incoming Webhooks — no OAuth app install required.

​
Setup

1

Create a Slack Incoming Webhook

  1. Go to api.slack.com/apps and create a new app (or select an existing one)
  2. Navigate to Incoming Webhooks and toggle it on
  3. Click Add New Webhook and select a channel
  4. Copy the webhook URL (starts with https://hooks.slack.com/services/...)
2

Create the alert channel in DevHelm

devhelm alert-channels create \
  --name "Engineering Alerts" \
  --type slack \
  --webhook-url "https://hooks.slack.com/services/T.../B.../xxx"

alertChannels:
  - name: Engineering Alerts
    config:
      channelType: slack
      webhookUrl: ${SLACK_WEBHOOK_URL}
      mentionText: "@channel"

curl -X POST https://api.devhelm.io/api/v1/alert-channels \
  -H "Authorization: Bearer $DEVHELM_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Engineering Alerts",
    "config": {
      "channelType": "slack",
      "webhookUrl": "https://hooks.slack.com/services/T.../B.../xxx",
      "mentionText": "@channel"
    }
  }'
3

Test the channel

devhelm alert-channels test <channel-id>

​
Configuration

FieldDescriptionRequired
webhookUrlSlack incoming webhook URLYes
mentionTextText to include for mentions (e.g., @channel, @here, <@U123>)No

​
Notification format

DevHelm sends rich Slack messages with:
  • Incident severity and status (color-coded)
  • Monitor name and type
  • Affected regions
  • Direct link to the incident in the Dashboard

​
Troubleshooting

The URL must start with https://hooks.slack.com/. If you’re using a Slack Workflow webhook, it won’t work — you need an Incoming Webhook.
  1. Check that the webhook isn’t revoked in your Slack app settings
  2. Verify the channel still exists
  3. Run devhelm alert-channels test <id> to see the delivery result