Skip to main content
Connect your Slack workspace so you can send templates and use interactive features like buttons and webhooks.

​
Watch the demo

​
Prerequisites

  • A Slack workspace where you have permission to install apps
  • Admin or owner permissions (or approval from an admin)
  • An active organization in LithoBlocks

​
Connect your workspace

​
Step 1: Initiate connection

  1. Navigate to Integrations in the sidebar
  2. Find the Slack section
  3. Click Connect Slack Workspace
Connect Slack Workspace You’ll be redirected to Slack’s authorization page.

​
Step 2: Authorize

  1. Select your workspace from the dropdown (if you’re in multiple workspaces)
  2. Review the requested permissions
  3. Click Allow to grant access
Slack authorization page

​
Step 3: Confirm

After authorization you’ll be redirected back; your Slack connection will appear in Integrations with a success message.

​
Required permissions

The connection’s consent screen lists the scopes requested by that Slack app version. The current manifest includes: The retained channel, file, and trigger scopes are not prerequisites for the workflows in this guide. Existing installations can have a different granted set; reconnect when a feature reports a missing permission.
Some workspaces require admin approval for app installations. If you see “Request to Install,” workspace admins must approve before you can complete the connection.

​
Add the bot to channels

Channel access depends on the destination and the permissions granted to your installation. Public channels: An installation with chat:write.public can post without joining first. If your installation lacks that scope, invite the bot or reconnect with the current permissions. Private channels: A channel member with permission to add apps must invite LithoBlocks. Knowing a private channel ID is not sufficient. Direct messages: Use a Slack user ID or a resolvable email in the connected workspace. Workspace policies and account state can still prevent delivery.

​
Test your connection

  1. Go to Templates
  2. Select or create a template
  3. Click Send to Slack
  4. Choose a test channel or send to yourself
  5. Verify the message appears in Slack

​
Managing your connection

​
View connection details

In Integrations you can see workspace name, who connected it, when it was established, and status (Active or Inactive).

​
Disconnect

  1. Go to Integrations
  2. Find your Slack connection
  3. Click Disconnect
  4. Confirm
Disconnecting will stop all message sending from templates and disable webhook interactions from existing messages. You can reconnect at any time.

​
Troubleshooting

Allow popups from the platform domain; try a different browser or network. Check with your workspace admin if restrictions apply.
Check connection status in Integrations, ensure the bot is in the target channel, and for DMs confirm the user is in the workspace. View detailed errors on the Usage page.
Check that the message was sent through LithoBlocks, that its destination or modal is still active, and that the Slack connection remains authorized. Inspect the interaction log before resending.

​
Next steps

Quickstart

Create your first template and send it to Slack.

Troubleshooting

Common issues and how to resolve them.