Skip to main content

What You'll Need

CredentialWhat it is
Tokenxoxb- prefixed bot token from Slack

​
Overview

Connect Parable to Slack using a custom Slack App with bot permissions for secure workspace data access.

Users

User profiles

Conversations

Public channels and private channels where the bot is a member; messages and threads in those channels only. No DMs or group DMs.

​
Prerequisites

Setup access in . These steps require , or a colleague with equivalent permissions who can create credentials for you.If that is not you, ask your administrator.

​
Setup Guide

1

Create Slack App

  1. Go to Slack API Apps
  2. Click Create New App → From scratch
  3. Name: Parable Integration
  4. Select your workspace
  5. Click Create App
2

Configure Bot Scopes

  1. Go to OAuth & Permissions in the sidebar
  2. Scroll to Bot Token Scopes
  3. Add these scopes:
ScopePurpose
channels:historyRead public channel messages
channels:readList public channels
groups:historyRead messages in private channels the bot is in
groups:readList private channels the bot is a member of
users:readRead user profiles
users:read.emailRead user email addresses
team:readRead workspace info
3

Install to Workspace

  1. Scroll up to OAuth Tokens for Your Workspace
  2. Click Install to Workspace
  3. Review permissions and click Allow
Slack opens an approval screen in the same browser tab. After you click Allow, use the browser back button if needed, then copy the Bot User OAuth Token from OAuth & Permissions in Slack.
4

Add App to Channels

Parable can only read messages from channels where Parable Integration is a member. This is required for both public and private channels.For each channel Parable should consume:
  1. Open the channel in Slack
  2. Add the app using one of these methods:
    • Type /invite @Parable Integration in the message box and send
    • Click the channel name → Integrations → Add apps → select Parable Integration
If you skip this step, those channels will be missing or empty in Parable after sync.
5

Copy Bot Token

After installation, copy the Bot User OAuth TokenIt starts with xoxb-
The token is persistently visible on the OAuth & Permissions page of your app at any time — return to api.slack.com/apps, select the app, and copy it again if needed. The token only becomes invalid if you uninstall and reinstall the app, or explicitly revoke it.
6

Enter values in the form

  1. Connection name (optional): A friendly label for this workspace in Parable.
  2. Token: Paste the Bot User OAuth Token (xoxb-...).
  3. Click Save & test connection.