You must enable javascript in order to use Slack. You can do this in your browser settings.
Go to Slack

Installation & permissions

The rundown
Read this if:You're still experimenting, prototyping, and exploring.
Read next:Basic app setup
Open beta for new Slack apps

This sneaky preview gives you access to new features in Slack apps. Since we're still finalizing these apps, a few features may not yet have arrived. We expect the final version of new Slack apps to be available within a few months.

What do arcade games and Slack APIs have in common? Sure, they're both fun—but to use them, you'll need a token.

Like the pinball machines of days past and present, Slack API endpoints don't let just anyone play. In an arcade, your token proves you obtained permission to play. In your Slack app, your token proves that your app has obtained permission to call an API method.

Whenever you build an app, you'll start by obtaining an access token.

Begin with basic app setup

Select all the scopes you need, and none you don't, for your bot user.

Install your app on a single workspace.

Grab a token through the friendly App Management UI.

An unfurled file in a Slack client
The app management scopes page

Level up with a new OAuth flow

Request specific scopes for your bot user on each workspace, with each scope clearly explained to users.

Let users in any workspace install your app.

Read our guide to the new OAuth flow for Slack apps.

Beyond these two paths to installation, you'll also find oodles of reference material in this library:

Quickstart: what's new

Use this quickstart guide if you're already familiar with creating Slack apps, and simply want to see what's different for new apps.

Verifying requests from Slack

Verify that requests originating from Slack are trustworthy: check out our guide to verifying requests from Slack.

Reference: token types

See a list of token types, with both current and legacy types explained.

Reference: scopes

See a list of the scopes you can obtain, along with which token they belong with. With arcade games, certain games can only be played with certain tokens, and it's the same with the Slack API: some tokens may only access certain scopes.