Messaging
Slack
Post Atlas notifications into Slack channels and convert Slack messages into tasks with a single shortcut.
What this connector does
- Post Atlas task and project notifications into selected Slack channels.
- Let users turn any Slack message into an Atlas task with the message action menu.
- Sync slash commands so /atlas can create tasks or lookups from any channel.
- Mirror channel membership so notifications respect Slack workspace privacy.
Before you begin
- You are a Slack Workspace Owner or Workspace Admin.
- Third-party apps are not blocked by Slack workspace settings.
- You can install apps to the workspace where Atlas will post.
Get your credentials
Open the Slack API dashboard
Sign in with the workspace owner account. api.slack.com/apps
Create a new app
Click Create New App, choose From scratch, name it Atlas, and pick the workspace where it should live.
Add OAuth scopes
Open OAuth & Permissions and add the scopes listed below under Bot Token Scopes.
Add the Atlas redirect URL
Still under OAuth & Permissions, add Redirect URL https://YOUR-ATLAS-HOST/oauth/callback/slack and click Save URLs.
Install to workspace and copy credentials
Click Install to Workspace, approve the scopes, then copy the Bot User OAuth Token, Client ID, and Client Secret (from Basic Information) into the Atlas Slack connector settings.
Required scopes and permissions
channels:readchat:writeusers:readchannels:historycommandsSetup checklist
- Create the provider app in a sandbox or development workspace.
- Add the Atlas redirect URL to the provider app configuration.
- Copy the client id, client secret, or API key.
- Paste the credentials into the Atlas connector settings page.
- Click Connect and complete the provider sign-in screen.
- Run Test connection from the connector page to verify health.
Troubleshooting
invalid_scope
You requested a scope the app is not configured to use. Add it under OAuth and Permissions and re-install.
not_in_channel
The Atlas bot must be invited into a private channel before it can post. Use /invite @atlas in the channel.
redirect_uri did not match
The Redirect URL list must contain the exact value Atlas sends. Trailing slashes matter.
Webhooks
Slack delivers events to the Atlas Events Request URL with a signed payload.
Events Atlas listens for
- message.channels
- app_mention
- message_action: Create Atlas task
- slash_commands: /atlas
Provider docs: https://api.slack.com/events-api
Disconnect and data deletion
- Click Disconnect on the Atlas Slack connector page to revoke the bot token.
- Open the Slack app directory, find Atlas, and click Remove app for the workspace.
- Atlas deletes locally cached channel and user metadata within 24 hours of disconnect.
Once you have the credentials above, paste them into the live connector page to finish connecting Slack.
Open the Slack connector page