Skip to main content
Requires creating a Slack app. Done once by the server admin — users then connect their own Slack accounts via the UI.

​
Server Setup

1

Create a Slack app

Go to api.slack.com/apps and click Create New App → From scratch. Give it a name and pick your workspace.
2

Add OAuth scopes

Go to OAuth & Permissions → Scopes → User Token Scopes and add:
channels:history
channels:read
im:history
im:read
mpim:history
users:read
users:read.email
3

Set the redirect URI

Under OAuth & Permissions → Redirect URLs, add:
https://api.yourdomain.com/api/oauth/slack/callback
4

Copy Client ID and Client Secret

Go to Basic Information → App Credentials and copy your Client ID and Client Secret.
5

Add to nous.env

SLACK_CLIENT_ID=your-client-id
SLACK_CLIENT_SECRET=your-client-secret
SLACK_REDIRECT_URI=https://api.yourdomain.com/api/oauth/slack/callback
Restart your containers after saving.

​
Connecting in Nous

  1. Go to Settings → Integrations
  2. Click + Add Integration → Slack
  3. Complete the OAuth flow in the popup

​
What gets synced

DataHowFrequency
Direct messagesSlack API (user token)Every hour