Slack Connector Configuration
Create a Slack app and generate the OAuth token required for Slack workspace migration.
Overview
The Slack connector requires creating a Slack app with specific permissions to access your workspace data. This guide walks through the complete setup process.
Administrator Required
You need Slack workspace administrator privileges to create apps and install them to your workspace.
Step 1: Create a New Slack App
- 1 Navigate to Slack API
Go to api.slack.com
- 2 Access Your Apps
Click "Your Apps" in the top right corner
- 3 Create New App
Click "Create New App" button
- 4 Configure App
- • App Name: Cloudiway Migration (or your preferred name)
- • Workspace: Select your Slack workspace
- 5 Create App
Click "Create App" to finish
Step 2: Configure Permissions
- 1 Open App Settings
From your app's Basic Information page
- 2 Add Features
Click "Add features and functionality"
- 3 Access Permissions
Click "Permissions" to navigate to OAuth & Permissions
- 4 Find Scopes Section
Scroll down to "Scopes" → "User Token Scopes"
Step 3: Add Required Scopes
Add all 12 of the following scopes to enable full migration access:
Channel Access
-
channels:historyAccess public channel messages
-
channels:readAccess public channel info
-
groups:historyAccess private channel messages
-
groups:readAccess private channel info
Direct Messages
-
im:historyAccess direct messages
-
im:readAccess DM info
-
mpim:historyAccess group messages
-
mpim:readAccess group message info
Files & Links
-
files:readAccess workspace files
-
links:readView URLs in messages
Users
-
users:readAccess user profiles
-
users:read.emailView email addresses
All Scopes Required
All 12 scopes must be added for complete migration functionality. Missing scopes will result in incomplete data migration.
Step 4: Install App & Generate Token
- 1 Install to Workspace
Scroll up and click "Install to Workspace"
- 2 Grant Permission
Review the permissions and click "Allow"
- 3 Copy OAuth Token
Copy the "User OAuth Token" (starts with
xoxp-)
Save Your Token
Copy and save the OAuth token immediately. You'll need it for the Cloudiway connector configuration.
Step 5: Cloudiway Connector Setup
- 1 Navigate to Connectors
In Cloudiway portal, go to Configuration → Connectors
- 2 Create Slack Connector
Click "New Connector" and select "Slack"
- 3 Enter OAuth Token
Paste your User OAuth Token into the token field
- 4 Test & Save
Click "Test" to verify, then "Save" to complete