Skip to main content

​
What this credential is for

Use Slack OAuth Credential for Slack-integrated nodes such as:

​
Create OAuth client in Slack

1

Open Slack API apps dashboard

Go to Slack API: Your Apps and sign in with the Slack account connected to your workspace.
2

Create or select a Slack app

In Slack API > Your Apps, click Create New App to create a new app (or open an existing app). Choose the workspace where this app will be installed.
3

Set OAuth redirect URL

In your app settings, go to Features > OAuth & Permissions > Redirect URLs. Add this exact URL:
https://staging-api.relai.ai/api/v1/credentials/slack-oauth/callback/
Save the redirect URL configuration.
The redirect URL must match exactly or OAuth authorization will fail.
4

Get Client ID and Client Secret

In your app settings, go to Settings > Basic Information > App Credentials. Copy the Client ID and Client Secret for use in RELAI.
5

Configure bot scopes

In your app settings, go to Features > OAuth & Permissions > Scopes > Bot Token Scopes. Add the bot token scopes required by your workflow.Required scopes shown in RELAI Slack credential form:
  • chat:write
  • channels:read
  • users:read
  • groups:read
  • im:read
  • mpim:read
6

Install app to workspace

In your app settings, go to Features > OAuth & Permissions > OAuth Tokens for Your Workspace. Click Install to Workspace (or Reinstall to Workspace after scope updates), then authorize the app.
7

Add bot to target channels

In Slack, open each target channel and add the app/bot to that channel (for example, via Integrations or /invite @your-bot-name). The bot must be in the channel for posting to succeed.

​
Create the credential in RELAI

Add Slack OAuth Credential form with redirect URL, client ID, client secret, and Slack permissions selection
1

Open credentials in RELAI

Go to the Credentials page. Click Create new credential > Create Slack OAuth Credential.
2

Fill in Slack OAuth fields

In the Add Slack OAuth Credential form:
  • Enter a credential name.
  • Enter the Slack app Client ID.
  • Enter the Slack app Client Secret.
  • Select the required Slack permissions.
3

Create and authorize

Click “Create”, complete Slack OAuth authorization, then select this credential in Slack nodes that require Slack OAuth Credential.

​
Scope guidance

Use the required scopes for your workflow. If one credential is shared by multiple Slack nodes, include the union of required scopes.
Use caseScope
Post messageschat:write
Read public channelschannels:read
Read usersusers:read
Read private channelsgroups:read
Read direct messagesim:read
Read group direct messagesmpim:read
If the app is not installed to workspace, is missing scopes, or the bot is not in the target channel, Slack actions will fail.