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, like message buttons and the Events API, visit 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.

Create a new legacy token

  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 that you'd like to create a token for.
  3. Click Create token. (You may see Request token if the Approved Apps feature is turned on for your workspace.)

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


Re-issue a token

  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'd like to re-issue a token for.
  3. Click Re-issue token. (You may see Request token if your workspace has the Approved Apps feature enabled.)

Note: You can only create and regenerate tokens for yourself. You're unable to create tokens for other members. 


Regenerate the token of a bot user

Custom integration bot users

  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.


Hubot or Lita integration bot tokens

  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.

Note: Only the person who set up the bot can regenerate the token.

 

Re-issue an internal app token

  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. 

Note: Only the app creator or collaborators can reinstall it to their workspace.

 

Re-issue an external app token

  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?
  • By default, all members except for Guests can use this feature.
  • Available on free and paid plans.

Related Articles

Recently Viewed Articles