Skip to content

Slack credentials#

You can use these credentials to authenticate the following nodes:

Prerequisites#

Create a Slack account.

Using OAuth#

Note for n8n Cloud users

You'll only need to enter the Credentials Name and click on the circle button in the OAuth section to connect your Slack account to n8n.

  1. Open the Slack API page.
  2. Click on the Create an app button and select From scratch.
  3. Enter an App Name in the corresponding field.
  4. Select a workspace for your app from the dropdown list.
  5. Click on the Create App button.
  6. Scroll down to the App Credentials section.
  7. Copy and paste Client ID and Client Secret in the corresponding fields of your n8n credentials.
  8. On the Basic Information page, navigate to Building Apps for Slack > Add features and functionality > Permissions.
  9. In the Redirect URLs section, click on Add New Redirect URL.
  10. Copy the OAuth Callback URL provided in n8n and paste it here.
  11. Click on the Save URLs button.
  12. Scroll down to the Scopes section.
  13. Add the required scopes under the Bot Token Scopes section. You can refer to the list of scopes on the Scopes and permissions documentation on Slack.
  14. Click on the circle button in the OAuth section to connect a Slack account to n8n.
  15. Click the Save button to save your credentials in n8n.
  16. Return to the Slack OAuth & Permissions page, scroll up to the OAuth Tokens for Your Workspace section and click on Install to Workspace button.
  17. Click on the Allow button.

Add OAuth Scopes to a Slack app#

Your app needs appropriate scopes and permissions to perform actions. For example, if you want to create a new channel, your app requires the channel:manage scope. To add scopes and permissions:

  1. Navigate to the Slack App dashboard page and select your app.
  2. Select OAuth & Permissions under the Feature section on the left sidebar.
  3. Scroll down to the Scopes section.
  4. If you're building a bot, select Add an OAuth Scope under the Bot Token Scopes.
  5. Select the permissions you want to give to your bot from the dropdown list.
  6. If you want the app to access user data and act on behalf of users that authorize them, add scopes under the User Token Scopes.
  7. When you add new scopes, Slack will ask you to reinstall the app. Select Reinstall your app on the top of the page and reinstall the app.

Refer to the official documentation on Scopes and permissions to learn more.

Using Access Token#

  1. Open the Slack API page.
  2. Select Create an app > From scratch.
  3. Enter an App Name.
  4. Select a workspace for your app from the dropdown list.
  5. Select Create App.
  6. In the Add features and functionality section select Permissions.

  7. Scroll down to the Scopes section:

    • If you want your app to act on behalf of users that authorize the app, add the required scopes under the User Token Scopes section.
    • If you're building a bot, add the required scopes under the Bot Token Scopes section.

    Scopes

    You can refer to the list of scopes on the officials Slack Scopes and permissions documentation.

  8. From the OAuth Tokens for Your Workspace section selec Install to Workspace.

  9. SelectAllow.
  10. In n8n, enter the Access Token created above.
  11. Select Save to save your credentials in n8n.