This guide walks you through creating a Slack app and getting a User Token so we can access your Slack data.
Time needed: ~5 minutes
- Go to https://api.slack.com/apps
- Sign in to Slack if prompted
- Click the green "Create New App" button
- Choose "From scratch"
- Enter any name (e.g., "Cheerful Integration")
- Select your workspace from the dropdown
- Click "Create App"
- In the left sidebar, click "OAuth & Permissions"
- Scroll down to the "User Token Scopes" section (NOT "Bot Token Scopes")
- Click "Add an OAuth Scope" and add each of these:
| Scope | What it allows |
|---|---|
channels:history |
Read messages in public channels |
channels:read |
See list of public channels |
groups:history |
Read messages in private channels |
groups:read |
See list of private channels |
im:history |
Read direct messages |
im:read |
See list of DMs |
mpim:history |
Read group DM messages |
mpim:read |
See list of group DMs |
users:read |
See basic user info |
users:read.email |
See user email addresses |
- Scroll back up to "OAuth Tokens for Your Workspace"
- Click the "Install to Workspace" button
- Review the permissions and click "Allow"
After installation, you'll see a "User OAuth Token" on the page.
- It starts with
xoxp- - Click the "Copy" button next to it
Send the token to us through a secure channel (not email or Slack DM).
Important: This token gives access to your Slack messages. Keep it private and don't share it publicly.
"I don't see the Install button"
- Make sure you added at least one scope in Step 2
"I need admin approval"
- Your Slack workspace may require admin approval for new apps
- Contact your Slack admin to approve the app
"I accidentally shared the token publicly"
- Go back to https://api.slack.com/apps
- Click your app, then "OAuth & Permissions"
- Click "Revoke Tokens" and reinstall to get a new one