Skip to main content

Connect Slack

Use this guide when you want Alerta to deliver alerts into Slack.

What This Guide Covers​

  • connecting Slack in Alerta
  • sending a Slack message with the public V2 API
  • replying to a Slack thread with the public V2 API

Before You Begin​

You will need:

  • an active Alerta session
  • the correct organization selected
  • permission to manage integrations
  • access to the Slack workspace where you want alerts delivered

Where To Start In Alerta​

Open the Integrations page in the app and choose Slack.

Setup Flow​

Slack uses a direct workspace connection flow inside Alerta:

  1. Click Slack in Integrations.
  2. Choose the Slack workspace you want to connect.
  3. Your browser redirects to Slack.
  4. Complete the Slack install or authorization flow for the intended workspace.
  5. Return to Alerta after the provider flow completes.
  6. Alerta saves the Slack integration and channel configuration.
  7. The connected Slack channel appears on the Channels page.

Public V2 Endpoints​

Slack public endpoints are:

  • POST /v2/slack/send
  • POST /v2/slack/reply

Read the current API guidance in Alerta API, or review the older provider-specific reference in Legacy APIs.

Slack-Specific Notes​

  • Slack send uses channel, not channelRef.
  • Slack replies use channelRef, channelId, and threadId.
  • If you send with replyTo: true, Alerta can return reply-ready Slack identifiers in replyData.
  • channelRef is an internal Alerta reference, not the Slack channel name.

API Reference​