Reinstalling the Slack Integration App to Fix Broken Notifications – DataHub Customer Support Portal

Area: Product Issues

Sub-Area: Slack Integration / Notifications

Issue

The DataHub Slack integration periodically stops working, causing an error state in the Notifications Settings page. When this occurs, users cannot configure or receive personal Slack notifications from DataHub. This can happen recurringly and is most commonly caused by an expired or revoked Slack bot token, a change in Slack app permissions within the workspace, or a stale credential stored in the integration configuration. The integration settings page may fail to load or display an error indicator next to the Slack configuration.

Error Messages

Failed to load integration settings
Slack integration is not configured

You Might Be Asking

Why does my Slack integration keep breaking in DataHub Cloud?
How do I fix the error shown in Settings → Notifications when Slack is not working?
How do I reinstall the DataHub Slack app to restore notifications?
Why are my DataHub Slack notifications no longer being delivered?

Solution

The recommended fix is to refresh or fully reinstall the Slack integration. A DataHub administrator must perform these steps.

Option 1: Refresh the Existing Integration

Log in to your DataHub Cloud instance as an administrator.
Navigate to Settings → Integrations → Slack.
Visit https://api.slack.com/apps and open your DataHub Slack app.
Retrieve the current Bot Token (under OAuth & Permissions) and the Signing Secret (under Basic Information).
Re-enter these values in the DataHub Slack integration settings form.
Click Update Configuration (or Save) to persist the new credentials.
Verify the integration status indicator returns to a healthy/connected state.

Option 2: Full Reinstallation (if Option 1 Does Not Resolve the Issue)

Navigate to Settings → Integrations → Slack in DataHub Cloud.
Remove the existing Slack integration entirely.
Wait approximately 30 seconds to allow the backend to clear the previous connection state.
Re-add the Slack integration from scratch by following the standard setup guide (linked below).
Generate a fresh bot token from your Slack workspace at https://api.slack.com/apps if the old token may have been revoked or expired.
Complete the configuration with the new credentials and verify that the Notifications Settings page no longer shows an error.

Verifying the Bot Token is Valid

To confirm your Slack bot token is active before re-entering it, you can test it against the Slack API directly:

curl -H "Authorization: Bearer <your-bot-token>" \
  https://slack.com/api/auth.test

A successful response will return "ok": true. If the token is invalid or revoked, you will receive "ok": false with an error such as invalid_auth, and you must regenerate the token from the Slack app console before updating DataHub.

Additional Notes

This issue recurs most commonly due to the Slack bot token being rotated, revoked, or expired in the Slack workspace without the DataHub integration being updated to match. If you experience this problem repeatedly, consider setting a reminder to audit your Slack app token health periodically.
In DataHub Cloud (managed deployments), credential storage is handled by the platform infrastructure. Only a DataHub administrator can update or reset the integration through the Settings UI — direct access to the underlying secret store is not available to end users.
If your Slack workspace administrator has changed the DataHub app's OAuth scopes or uninstalled the app from the workspace, you will need to reinstall the Slack app in your workspace before reconfiguring the integration in DataHub.
If errors persist after following both options above, contact DataHub Support for direct investigation of the integration service logs.
This behavior has been observed across multiple DataHub Cloud versions. A known improvement to the OAuth binding flow was introduced in a later release; if you are on an older version and experience recurring OAuth-related failures, upgrading to a newer release may provide additional stability.