For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Dashboard
User GuideDeveloper GuidesAPI Reference
User GuideDeveloper GuidesAPI Reference
  • Getting Started
    • What is Runtype?
    • Creating your account
    • Platform Keys vs. BYOK
    • Understanding the Runtype UI
    • Quickstart: Social Media Post Generator
    • Quickstart: From Agent to Chat Widget
  • Dashboard
    • What is the Dashboard?
    • Daily Executions
  • Playground
    • What is the Playground?
  • Products & Surfaces
    • What are Products?
    • What are Surfaces?
    • Creating a Product
    • Setting up a Chat Surface
    • Setting up an API Surface
    • Setting up an MCP Surface
    • Setting up an A2A Surface
    • Setting up a Slack Surface
  • Flows
    • What are Flows?
    • Creating and Editing Flows
    • Flow step types overview
    • Agent and Flow Templates
  • Agents
    • What are Agents?
    • Creating and configuring Agents
    • Agent tools
  • Records
    • What are Records?
    • Creating and managing records
  • Tools
    • What are Tools?
    • Built-in Tools
    • Creating custom tools
    • Creating external tools
  • Evals
    • What are Evals?
    • Running an Eval
  • Schedules
    • What are Schedules?
  • Logs
    • What are Logs?
  • Integrations
    • Connecting AI model providers
  • Settings
    • What's in Settings?
    • Available AI models
  • Troubleshooting & FAQ
    • FAQ
    • Rate Limits and Usage
    • Managing Runtype with Claude
Dashboard
LogoLogo
On this page
  • Create the Slack Surface
  • Connect the Slack app
  • Choose how the Surface responds
  • Test the connection
  • What’s next
Products & Surfaces

Setting up a Slack Surface

Was this page helpful?
Previous

What are Flows?

Next
Built with

Use a Slack Surface to let people interact with a Product from Slack. It works well for direct messages, mentions, channels, and threaded replies.

Before you begin, create a Product and decide which Capability will handle Slack messages. You will also need access to your Slack workspace so you can create and install a Slack app.

Create the Slack Surface

  1. Open the Product you want to connect to Slack.
  2. Go to Surfaces and click Add Surface.
  3. Select Slack.
  4. Enter a name for the Slack app.
  5. Review the manifest preview and create the app in Slack.

The setup wizard guides you through the Slack app fields Runtype needs to connect the Surface.

Connect the Slack app

  1. In Slack, open the app you created and copy the App ID from Basic Information.
  2. Copy the Signing Secret from the same page.
  3. Return to Runtype and paste both values into the Slack setup wizard.
  4. Install the app to your workspace in Slack.
  5. Copy the Bot User OAuth Token and paste it into Runtype.

Runtype validates the connection and shows the connected workspace when setup is complete.

Choose how the Surface responds

A Slack Surface can receive direct messages, channel messages, mentions, and replies in threads. After the Surface is connected, attach the right Capability so incoming Slack messages route to the Flow or Agent you want to run.

If you have not attached a Capability yet, see Adding Capabilities to a product.

Test the connection

  1. Send a direct message to the Slack app or mention it in a channel where it is available.
  2. Confirm the message reaches your Product.
  3. Check that the response appears in Slack.

If verification succeeds, your Slack Surface is ready to use.

Start with direct messages while you test. Once the response looks right, expand to channels or mention-based workflows.

What’s next

To understand how Surfaces work across Products, read What are Surfaces?. If you are still deciding how to expose your Product, compare this setup with Setting up a chat Surface and Setting up an API Surface.