Skip to content
Release: Australia · Updated: 2026-03-12 · Official documentation · View source

Set up the Slack account

Set up the Slack account.

Before you begin

Role required: none

Procedure

  1. From the Slack developer program, sign in to your Slack developer account.

  2. On the Slack dashboard, select Your apps from the upper right-hand corner of the screen.

  3. From the Your Apps screen, select Create an App.

  4. On the Create an app dialog, select From scratch.

  5. On the Name app & choose workspace dialog, fill out the fields:

    • App Name - name for the application you are going to create. Make a note of the app name because you will need it in the remaining procedures.
    • Pick a workspace to develop your app in - from the drop-down list, select the workspace where your app will reside. Make a note of the app name because you will need it in the remaining procedures.
    • Select Create App.
  6. In a browser window, enter https://api.slack.com/apps and select the app you created in step 5.

  7. From settings, select Oauth & Permissions.

  8. In the Redirect URLs dialog, enter https://{instance_url}/oauth_redirect.do

  9. Select Add New Direct URL.

  10. Add these Oauth scopes from the User Token Scope section:

    OAuth ScopeDescription
    channels:historyView messages and other content in a user's public channels.
    channels:readView basic information about public channels in a workspace.
    channels:writeManage a user's public channels and create new ones on a user's behalf.
    channels:write.invitesInvite members to public channels.
    chat:writeSend messages on a user's behalf.
    files:writeUpload, edit, and delete files on a user's behalf.
    groups:readView basic information about a user's private channels.
    groups:writeManage a user's private channels and create new ones on a user's behalf.
    groups:write.invitesInvite members to private channels.
    im:readView basic information about a user's direct messages.
    im:writeStart direct messages with people on a user's behalf.
    mpin:readView basic information about a user's group direct messages.
    mpin:writeStart group direct messages with people on a user's behalf.
    users:readView people in a workspace.
    users:read.emailView email addresses of people in a workspace.
  11. Add these Oauth scopes from the Bot Token Scope section:

    OAuth ScopeDescription
    users:readView people in a workspace.
    users:read.emailView email addresses of people in a workspace.