Create and regenerate API tokens

Note: This article mentions legacy components, an older method of adding integrations to your workspace. For the newest platform features, such as message buttons and the events API, see Building Slack apps.

API tokens can be created for both members and bot users. For added security, it’s a good idea to rotate these tokens periodically.


Legacy test tokens

Create a token

Test tokens are just for you, so make sure you treat them as you would a password. Never share tokens with other users or applications.

  1. From your desktop, visit the Legacy tokens page at api.slack.com/custom-integrations/legacy-tokens.
  2. Scroll to find the workspace and member you want to create a token for.
  3. Click Create token. (You might see Request token if the approved apps feature is turned on for your workspace.)


Reissue a token

Members can only create and regenerate tokens for themselves and not for other members. Here’s how:

  1. From your desktop, visit the Legacy tokens page at api.slack.com/custom-integrations/legacy-tokens.
  2. Scroll to find the workspace and user that you want to reissue a token for.
  3. Click Reissue token. (You might see Request token if your workspace has the approved apps feature enabled.)

Note: API tester tokens are quite powerful and it is best practice to revoke them if they are not being used. Slack will automatically revoke old tokens if they remain unused for long periods of time.


Bot user tokens

Regenerate custom integration bot user tokens

  1. Visit the Legacy custom integrations page from your desktop at my.slack.com/apps/manage/custom-integrations.
  2. Click  Edit configuration next to the bot user you want to change.
  3. On the configuration page, click Regenerate below the current token. This is the new token you can use anywhere you need.


Regenerate Hubot or Lita integration bot tokens

The person who set up the bot can regenerate the token using the instructions below:

  1. Visit the App Directory at my.slack.com/apps/manage on your desktop.
  2. Click  Edit configuration next to the integration.
  3. On the configuration page, click Regenerate below the current token. This is the new token you can use anywhere you need.


Internal app tokens

Only the creator or collaborators can reinstall an app to their workspace. Here’s how:

  1. Visit Your apps at api.slack.com/apps.
  2. Click on an app. 
  3. In the Install app section, click Reinstall app. Your new tokens will appear at the top of the page.


External app tokens

  1. Visit an app’s page in the Slack App Directory.
  2. Click Remove app at the bottom of the page.
  3. Complete the steps to reinstall the app.  

Note: If the approved apps feature is turned on, only a workspace owner or a member who can manage apps can reinstall an external app.

Who can use this feature?
  • All members except guests (default)
  • Free, Standard, Plus and Enterprise Grid subscriptions