Unified.to
Blog

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

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.

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
  4. Under Bot 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
  2. Enter your Client ID and Client secret from the steps above
  3. Save your changes

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

Happy building!

Blog