Update required: Slack API apps (On-premises)

April 15, 2021 | Last updated: June 25, 2021

Update required: Slack API apps (On-premises)

Buddy communicates with the Slack API via a dedicated app. While cloud accounts use the official Buddy app by default, on-premises users need to configure the application by hand. This is performed when adding the Slack integration for the first time, or from the 3-rd Party Apps tab in the admin settings of your instance.

Due to changes in Slack's authorization mode, applications created after February 24, 2021, are no longer able to communicate with Slack's API. With the release of Buddy v2.3.107, however, it is now possible to migrate your existing Slack app so that it supports the new authorization.

Without the migration, it is not possible to add new Slack integrations regardless of your client version. All existing ones, however, will continue to work uninterrupted.
This applies to Buddy on-premises only – cloud users are not affected by this change.

What you need to do

To update Slack application, you need to do two things:

  1. Upgrade your instance to v2.3.107 or newer.
  2. Update your Buddy application on Slack so that it supports granular scopes.

Migrating Slack app to granular scopes

  1. Visit api.slack.com/apps.
  2. Find and edit the app you are using for Buddy standalone.
  3. Under the Tools section, click the Update to Granular Scopes option:

Slack app settingsSlack app settings

  1. Now you have to select the scopes for your Slack bot. Make sure to select the following:

Updating app scopesUpdating app scopes

  1. Continue to the next step. You will be prompted to select user token scopes – do not select anything here and proceed:

User token scopesUser token scopes

  1. Step 3 is just a verification step. Review your scopes and if everything checks out click Yes, migrate my app:


And that's it – your Slack app has been migrated and you can add new integrations again.

If you're having any trouble with the process, feel free to contact our support and we'll' do our best to help you out.


Jarek Dylewski

Jarek Dylewski

Customer Support

A journalist and an SEO specialist trying to find himself in the unforgiving world of coders. Gamer, a non-fiction literature fan and obsessive carnivore. Jarek uses his talents to convert the programming lingo into a cohesive and approachable narration.