> ## Documentation Index
> Fetch the complete documentation index at: https://docs.devhelm.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Slack

> Send monitor incident alerts to Slack channels using incoming webhooks

Connect DevHelm to Slack to receive incident notifications in your channels. DevHelm uses Slack's **Incoming Webhooks** — no OAuth app install required.

## Setup

<Steps>
  <Step title="Create a Slack Incoming Webhook">
    1. Go to [api.slack.com/apps](https://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/...`)
  </Step>

  <Step title="Create the alert channel in DevHelm">
    <CodeGroup>
      ```bash CLI theme={null}
      devhelm alert-channels create \
        --name "Engineering Alerts" \
        --type slack \
        --webhook-url "https://hooks.slack.com/services/T.../B.../xxx"
      ```

      ```yaml devhelm.yml theme={null}
      alertChannels:
        - name: Engineering Alerts
          config:
            channelType: slack
            webhookUrl: ${SLACK_WEBHOOK_URL}
            mentionText: "@channel"
      ```

      ```bash API theme={null}
      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"
          }
        }'
      ```
    </CodeGroup>
  </Step>

  <Step title="Test the channel">
    ```bash theme={null}
    devhelm alert-channels test <channel-id>
    ```
  </Step>
</Steps>

## Configuration

| Field         | Description                                                         | Required |
| ------------- | ------------------------------------------------------------------- | -------- |
| `webhookUrl`  | Slack incoming webhook URL                                          | Yes      |
| `mentionText` | Text 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

<AccordionGroup>
  <Accordion title="Webhook URL rejected">
    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.
  </Accordion>

  <Accordion title="Messages not appearing">
    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
  </Accordion>
</AccordionGroup>