Skip to content
API reference Go to app

Configure Slack

1 min read

Slack integrations send selected Hawzu defect notifications to a Slack channel.


Prepare a Slack bot token. The setup window shows the required Slack scopes:

  • chat:write
  • channels:read
  • groups:read
  • im:read
  • mpim:read

Install the Slack app to the workspace and copy the Bot User OAuth Token, which starts with xoxb-.


  1. Open the workspace Integrations page.
  2. Select Add Integration.
  3. Search for Slack and select it.
  4. Add an optional integration name and description.
  5. Choose All Projects or Selected Projects.

Project scope controls where the Slack connection is available in Hawzu.


Enter the Slack bot token and select Test Connection.

After the connection succeeds, Hawzu loads available Slack channels.


Select the Channel where notifications should be sent. A channel is required before saving the Slack integration.

If no channels appear, check the bot token, Slack scopes, and whether the Slack app has access to the expected channels.


Two notification options are selected by default:

  • On Create Defect
  • On Status Update

Optional notifications are available for:

  • Assignee changes
  • Comments
  • Traceability changes
  • Priority changes
  • Severity changes

Turn on optional notifications only when the Slack channel needs that detail.


Save is available after the connection succeeds and a Slack channel is selected.

After saving, Slack appears in the Integrations table with its status, project scope, channel, and notification preferences.