Create and regenerate API tokens

Note: This article covers information about legacy methods for adding integrations to your Slack workspace. Visit Slack API for the latest on platform features. 

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

Note: It’s no longer possible to create new legacy test tokens. If you need new tokens to interact with the Slack API, create a Slack app instead.

Re-issue a token

Members can only regenerate tokens for themselves. Test tokens are just for you, so be sure to treat them as you would a password. Never share tokens with other users or applications.

  1. From your desktop, visit the auth.revoke page at api.slack.com/methods/auth.revoke/test to revoke your token.
  2. Then, visit the Legacy Tokens page at api.slack.com/custom-integrations/legacy-tokens.
  3. Scroll to find the workspace and user that you'd like to re-issue a token for.
  4. Click Re-issue token. (You may see Request token if your workspace has app approval enabled.)

Note: API tester tokens are quite powerful and it is a 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'd like to change.
  3. On the configuration page, click Regenerate below the current token. This is the new token you can use anywhere you need it.


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 it.


Custom or third-party app tokens

  1. Visit the App Directory at my.slack.com/apps/manage on your desktop. 
  2. Click on the Installed apps tab.
  3. Search for and select an app.
  4. For a custom app, click Remove App at the bottom of the page. For a third-party app, click the Configuration tab from the app page, then click Remove App
  5. Complete the steps to reinstall the app.  

Note: If app approval is enabled, only Workspace Owners and members with permission to manage apps can reinstall a third-party app.

Who can use this feature?
  • All members, except guests (default)
  • Available on all plans