Skip to main content

Slack

Allowing Breakout to access Slack

T
Written by Tripti

Allow Breakout to access Slack so that Breakout can send workspace notifications and route workflow updates to approved Slack channels.

Prerequisites

Use a Slack account that can install or approve apps for the workspace. If your Slack organization restricts app installs, ask a Slack workspace owner or app manager to approve the connection.

Decide which channels should receive Breakout notifications. Connecting Slack authorizes the workspace. Channel selection can be managed after the connection has been completed.

Allowing Breakout to access Slack

  1. Click your name to navigate to Settings

  2. Click Integrations and then toggle the switch on in the Slack card. The Slack approval window opens.

  3. Select the workspace

  4. Review app permissions and then click Allow.

Slack permission

Why Breakout needs it

chat:write

Send lead, workflow, and operational notifications to selected Slack channels.

channels:join

Join public channels when needed so Breakout can post where notifications are configured.

channels:read

List and validate channels for the channel-management screen.

users:read

Read Slack user profile metadata for user matching and notification routing.

users:read.email

Match Slack users to workspace users by email when routing notifications.

Return to Breakout and wait for the Slack integration to show as Connected. It may take a few minutes for the status to update on the Integrations page.

  • If the Slack approval window closes but the integration still doesn't show as connected, refresh the Integrations page.

  • If Slack still appears as Disconnected, reconnect the integration and make sure you complete the Slack approval process successfully.

Verifying the connection

Slack should show as connected on the Integrations page in Breakout. Test with a low-risk notification or ask your customer success manager to trigger a test event for you.

Disconnecting or reconnecting Slack

Disconnect Slack in these cases:

  • Selected the wrong Slack workspace

  • Changed workspace ownership

  • Revoked Slack app access

Reconnect with the intended workspace.

Did this answer your question?