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

Go to the Slack API website and sign into your Slack account
Click Create New App
Select From scratch
Enter your app's name
Select the workspace where you want to install and test out your app
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.

From your app's settings page, navigate to OAuth & Permissions
Under Redirect URLs, enter: https://api.unified.to/oauth/code
Click Save URLs
Under Bot Token Scopes, click Add an OAuth Scope
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

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

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

Happy building!

Blog