Unified.to
All articles

How to register a Slack developer account and get OAuth 2 credentials

January 3, 2025

This guide walks you through how to register a Slack developer account, obtain OAuth 2 credentials, and configure scopes for your application.

Before you begin

Make sure you have:

  • A Slack account
  • Admin access to a Slack workspace where you can test your app

Create a Slack app

  1. Go to the Slack API website and sign into your Slack account
  2. Click Create New App
  3. Select From scratch
  4. Enter your app's name
  5. Select the workspace where you want to install and test out your app
  6. Click Create App
    Screenshot_2025-01-03_at_11.13.30_AM.png

After you create your app, you'll be redirected to the app's settings page where you can find your Client Id and Client Secret. Make a note of these as you will need them to activate the Slack integration on Unfiied.to.

Screenshot_2025-01-03_at_11.15.20_AM.png

Note: Store these values securely - never commit them to version control!

Configure OAuth 2 settings

In addition to activating the Slack integration, you'll need to configure the redirect URL and enable the correct scopes in order to successfully authorize a connection with Unified.to.

  1. From your app's settings page, navigate to OAuth & Permissions
  2. Under Redirect URLs, enter: https://api.unified.to/oauth/code
  3. Click Save URLs
    Screenshot_2025-01-03_at_11.18.11_AM.png
  4. If you are using the SlackBot integration, use Bot Token Scopes. If not, then use User Token Scopes. click Add an OAuth Scope
  5. Search for and add the scopes you need for your application - refer to this page to see the scopes that are supported by Unified.
    1. For example, if you want to read messages, then you should choose the scopes that map to :
      1. messaging_channel_read: im:read, mpim:read, channels:read, groups:read
      2. messaging_message_read: im:read, im:history, mpim:read, mpim:history, channels:history, channels:read, groups:read, groups:history

Activate the Slack integration with your credentials

  1. Go to https://app.unified.to/integrations/slack?tab=auth or  https://app.unified.to/integrations/slackbot?tab=auth
  2. Enter your Client ID and Client secret from the steps above
  3. Save your changes

For a Slack Bot, follow these additional instructions

  1. In the left sidebar, go to "App Home"
  2. Under "Your App's Presence in Slack", click "Add" or "Edit"
  3. Set a Display Name and Default Username for your bot
  4. Toggle on "Always Show My Bot as Online" (optional)
  5. Go to "Event Subscriptions" in sidebar
  6. Toggle "Enable Events" to On
  7. Enter the Unified webhook URL https://api.unified.to/webhook/workspace/slackbot?workspace_id={ID}
  8. Subscribe to most bot events like:
    • message.channels
    • app_mention
    • message.im
  9. Go to "Interactivity & Shortcuts" to enable receiving information about button events
  10. Toggle On and enter in https://api.unified.to/webhook/workspace/slackbot?workspace_id={ID}

When a user authorizes your slackbot integration, their user ID will be stored in connection.auth.user_id and the bot ID will be stored in connection.auth.app_id .

Congratulations, you're now ready to use the Slack integration in your application.

Happy building!

All articles