---
title: "Slack alerts"
description: "Create a Slack Incoming Webhook, connect it in BooleanSMTP, send a test alert, and fix the most common errors."
image: "https://booleansmtp.com/docs/og.png"
---

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

# Slack alerts

BooleanSMTP posts a Slack message the moment an outgoing email finally fails to send. Setup uses a Slack Incoming Webhook
you create yourself — BooleanSMTP only ever sees the webhook URL you paste in.

## Create a Slack Incoming Webhook

1. In Slack, add the **Incoming Webhooks** app to your workspace (**Apps → search "Incoming WebHooks" → Add to Slack**).
2. Choose the channel alerts should post into, then add the integration.
3. Slack shows you a **Webhook URL** that looks like `https://hooks.slack.com/services/T00000000/B00000000/XXXXXXXXXXXXXXXXXXXXXXXX`.
   Copy it. Anyone with this URL can post messages into that channel, so keep it private.

## Connect Slack in BooleanSMTP

1. In the BooleanSMTP sidebar, click **Alerts**.
2. Find **Slack** in the provider list and click **Set up**.

3. Under **Settings**, paste the URL you copied into **Incoming Webhook URL**.
4. Leave **This webhook URL is proxied through a third-party relay** unchecked, unless you are intentionally routing the
   webhook through your own proxy instead of pointing straight at Slack. Checking it accepts any HTTPS URL instead of just
   `hooks.slack.com`.

## Send a test alert

1. Leave **Send alerts** on. BooleanSMTP does not send real alerts through a provider that is off.
2. Click **Send Test**. BooleanSMTP posts a real message to Slack using the values currently in the form.
3. Click **Save**.

A failed test shows Slack's own error text, not just "failed" — see below for what the common ones mean.

## Common errors

**"Slack Webhook URL is required."** — the **Incoming Webhook URL** field is empty.

**"This does not look like a Slack webhook URL."** — the URL doesn't match Slack's webhook shape. Check you copied the
full URL Slack generated, not a different service's webhook — or check **This webhook URL is proxied through a
third-party relay** if you're intentionally using a proxy.

**"channel_not_found"** — the webhook was deleted, or its channel was removed. Create a new Incoming Webhook and update the
URL here.

**"channel_is_archived"** — the destination channel was archived in Slack. Unarchive it, or create a new webhook pointing
at an active channel.

**A rate-limit message** — Slack is rate-limiting this webhook. This is rare for normal alert volume; if you see it often,
several sites are likely sharing one webhook — create a separate webhook per site.

**Send Test worked, but no alerts arrive** — confirm **Send alerts** is on and you clicked **Save**.

**Alerts arrive in the wrong channel** — the webhook URL fixes the destination channel in Slack; there's no separate
channel selector in BooleanSMTP. Create a new webhook against the right channel and update the URL here.

See also: [Alerts](/docs/alerts/), [Discord alerts](/docs/alerts/discord/), [Telegram alerts](/docs/alerts/telegram/).

Source: https://booleansmtp.com/docs/alerts/slack/index.mdx