Skip to main content
The Slack connection delivers each daily digest to your workspace. Connect once at the workspace level, then pick the channel the daily digest is posted to.
Before you start
  • You need permission to install apps in your Slack workspace, or a workspace admin who can approve the install for you.
  • Pick the destination channel ahead of time. Spark posts to one channel per workspace.

​
Connect the workspace

1

Open Settings → Integrations → Slack

From the dashboard, open Settings, then Integrations, then Slack. The status card shows Connect Slack when no workspace is linked.
2

Click Connect Slack Workspace

The button opens Slack’s OAuth flow in a new tab. Sign in to Slack if prompted.
3

Approve the install

Slack lists the permissions Spark requests (see below) and asks you to approve. If your workspace restricts third-party app installs, Slack shows a Request to install screen instead. Submit the request and ask a workspace admin to approve it.
4

Confirm the connection

Once Slack confirms the install, your browser is redirected back to the Slack settings page in Spark. The status card now shows the workspace name and a Connected indicator.

​
Pick the delivery channel

The channel picker appears below the workspace card once Slack is connected. Open it, then pick the channel the digest should be posted in. Spark loads the channel list lazily, so the first open may take a second while it fetches your workspace’s channels. You can change the channel at any time from the same picker. Spark immediately posts subsequent digests to the new channel.

​
Required permissions

Spark requests these Slack OAuth scopes during the install:
  • chat:write: Post the daily digest message to the selected channel.
  • chat:write.public: Post to public channels without Spark being invited first.
  • channels:read: List public channels in the channel picker.
  • groups:read: List private channels Spark has been invited to.
  • channels:history and groups:history: Read message history for vote and reaction tracking on published digests.
  • users:read: Look up display names so vote and reaction credits show real names instead of raw Slack user IDs.
Spark does not request DM or admin scopes.

​
Status states

The Slack settings card shows one of five states. Each state suggests the action that moves you forward.
  • disconnected: No workspace is linked. Click Connect Slack Workspace to start the OAuth flow.
  • approval_required: Slack told us your workspace admin must approve the install before it completes. Send the install request from Slack’s approval screen, then retry from the Spark settings card.
  • connected_unconfigured: Workspace is linked but no delivery channel is picked. Use the channel picker to choose one. Digests will not publish until this is set.
  • ready: Workspace is linked, a channel is picked, and Spark can deliver. No action needed.
  • invalid: The bot token was revoked or expired. This happens when a workspace admin removes the app on Slack’s side. Click Reconnect Slack Workspace to re-authorize.

​
Reconnect or disconnect

Click Reconnect Slack Workspace from the invalid state to re-run the OAuth flow. The new install replaces the previous credential without losing your channel selection. Click Disconnect from any connected state to remove the link entirely. This clears the channel selection. Future digests pause until you reconnect and pick a channel again.