---
title: "How to register a Slack developer account and get OAuth 2 credentials"
img: https://s3.us-east-2.amazonaws.com/unified-article-images/how_to_register_a_slack_developer_account_and_get_oauth_2_credentials-icon.png
date: 2025-01-03T00:00:00.000Z
tag: Guides
description: "This guide walks you through how to register a Slack developer account, obtain OAuth 2 credentials, and configure scopes for your application."
url: "https://docs.unified.to/guides/how_to_register_a_slack_developer_account_and_get_oauth_2_credentials"
---

# 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](https://api.slack.com/apps) 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](https://s3.us-east-2.amazonaws.com/unified-article-images/how_to_register_a_slack_developer_account_and_get_oauth_2_credentials-0.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](https://s3.us-east-2.amazonaws.com/unified-article-images/how_to_register_a_slack_developer_account_and_get_oauth_2_credentials-1.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`](https://api.unified.to/oauth/code)
3. Click **Save URLs**

    ![Screenshot_2025-01-03_at_11.18.11_AM.png](https://s3.us-east-2.amazonaws.com/unified-article-images/how_to_register_a_slack_developer_account_and_get_oauth_2_credentials-2.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 ](https://app.unified.to/integrations/slack?tab=oauth2)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](https://app.unified.to/integrations/slack?tab=auth) or  [https://app.unified.to/integrations/slackbot?tab=auth](https://app.unified.to/integrations/slack?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!