Slack API

Send messages, manage channels, and integrate with Slack workspaces from your Spala flows.

Slack API

The Slack API addon connects your Spala flows to a Slack workspace. Send messages to channels, post notifications, and build automated workflows that keep your team informed about important events.

Installation

1. Enable the Slack API addon from the Addons panel
2. Create a Slack App at api.slack.com/apps and install it to your workspace
3. Enter the Bot Token in the addon configuration

Configuration

Available Steps

Send Message

Posts a message to a Slack channel.

Send Direct Message

Sends a direct message to a Slack user.

Example: Deployment Notification

// Scheduled task or event trigger

// Step 1: Send Message (Slack addon)
// channel: '#deployments'
// text: ':rocket: *Deployment Complete*\nVersion ' + vars.version + ' has been deployed to production.'

Example: Error Alert with Block Kit

// Error handler in a critical flow

// Step 1: Send Message (Slack addon)
// channel: '#alerts'
// text: 'Error in payment processing'
// blocks: [
//   {
//     type: 'section',
//     text: { type: 'mrkdwn', text: ':warning: *Payment Processing Error*' }
//   },
//   {
//     type: 'section',
//     fields: [
//       { type: 'mrkdwn', text: '*Order ID:*\n' + vars.orderId },
//       { type: 'mrkdwn', text: '*Error:*\n' + vars.error.message },
//       { type: 'mrkdwn', text: '*Time:*\n' + new Date().toISOString() }
//     ]
//   }
// ]

Your Slack App needs the chat:write scope to post messages. Add additional scopes like channels:read and users:read if your flows need to look up channel or user information.

Use channel IDs instead of channel names when possible. Channel names can change, but IDs are permanent. Find a channel's ID in Slack by right-clicking the channel name and selecting "View channel details".

Slack Bot User OAuth Token (starts with xoxb-). Found in your Slack App settings under OAuth & Permissions.
Channel ID or name (e.g., "#general" or "C0123456789").
The message text. Supports Slack markdown formatting.
Block Kit layout blocks for rich message formatting (array of block objects).
The Slack user ID (starts with U).
The message text.
Addons Overview
/addons
Browse available addons
Installing Addons
/addons/installing
Enable and configure addons in your project