Slack Alerts

Deliver event notifications as rich Block Kit messages to your Slack channels. Bold headers, formatted fields, and clickable buttons, not just plain text.

How it works

1. Connect your Slack workspace via OAuth in the dashboard
2. Add a Slack destination to a router
3. Pick a Slack channel from the dropdown
4. Customise the message layout with the Event Designer
5. Events matching the router’s pattern post messages to that channel

One Slack connection can be used across multiple router destinations targeting different channels.

Block Kit messages

API Alerts sends structured Block Kit messages, not plain text. The Event Designer lets you configure:

• Header. Bold title block, e.g. {{title}}.
• Text. Message body, e.g. {{message}}.
• Fields. Two-column key/value pairs like Event, Tags, or custom data fields.
• Buttons. Clickable links, e.g. “Open Link” pointing to {{link}}.

Each block is optional and removable. You can add custom fields and buttons. Blocks with empty values are automatically omitted.

Template variables

Use {{variable}} syntax to insert event data into any block. Access nested data with {{data.name}} or {{data.order.total}}. Set fallbacks with {{title|No title}}.

See the full list in the Template Variables reference.

Preview

The Event Designer includes a live preview that renders your template with real event data from your workspace. Select different recent events to see how your message will look.

Channel selection

After connecting your Slack workspace, you can select any channel the bot has access to.

• Public channels. The bot joins automatically on the first message delivery. No action required.
• Private channels. Slack does not let bots add themselves to private channels. Open the channel in Slack and run /invite @API Alerts first, otherwise delivery fails with a “not in channel” error.

Multiple destinations

A single Slack integration (one workspace connection) can be used in multiple router destinations. Route different event patterns to different Slack channels:

• user.* events → #customers
• deploy.* events → #engineering
• payment.* events → #revenue

Get started

1. Open your workspace in the dashboard
2. Go to Integrations and click “Add to Slack”
3. Authorise API Alerts in your Slack workspace
4. Add a Slack destination to a router and pick a channel
5. Send a test event to see the Block Kit message in Slack