Try it free

Set up Slack Connector

  • Latest Dynatrace
  • How-to guide
  • 5-min read
  • Published Apr 29, 2026

Set up Slack Connector Slack Connector to connect Workflows Workflows to a Slack workspace. With this connection, your team can receive automated notifications, act on approval requests, and respond to incidents without leaving Slack.

Prerequisites

  • Access to a Slack workspace.
  • Permissions to create and install an app in the Slack workspace.

Set up Slack Connector

1. Add a new host pattern in External requests

External requests enable outbound network connections from your Dynatrace environment to external services. They allow you to control access to public endpoints from the AppEngine with app functions and functions in Dashboards, Notebooks, and Automations.

  1. Go to Settings Settings > General > External requests.

  2. Select New host pattern.

  3. Add the domain names.

  4. Select Add.

This way you can granularly control the web services your functions can connect to.

2. Grant permissions to Workflows

Workflows Workflows requires certain permissions to run actions on your behalf. Other permissions are required for actions bundled with Slack Connector Slack Connector.

To fine-tune permissions granted to Workflows:

  1. Go to Workflows and select Settings > Authorization settings.
  2. Select the following permissions besides the general Workflows permission.
    • app-settings:objects:read
    • app-settings:objects:write
    • state:app-states:read
    • state:app-states:write
    • state:app-states:delete
    • state:user-app-states:read
    • state:user-app-states:write
    • state:user-app-states:delete

For more on general Workflows user permissions, see Manage workflow permissions.

3. In Slack: Create an app

For Slack Connector Slack Connector actions to interact with your Slack workspace, you first need to create an app for Dynatrace in Slack and authorize its connection.

  1. Go to Slack API and select Create an App.

  2. In the Create an app window, select From an app manifest.

  3. In the Pick a workspace to develop your app window, select the Slack workspace you want to connect to and select Next.

  4. In the Enter app manifest below window, paste the manifest JSON provided below into the JSON tab. Replace <app-name> and <bot-name> with values of your choice, for example, Dynatrace. For more information on the manifest JSON, see Slack documentation.

    Slack manifest with all required permissions
    {
      "_metadata": {
        "major_version": 2,
        "minor_version": 1
      },
      "display_information": {
        "name": "<app-name>"
      },
      "features": {
        "bot_user": {
            "display_name": "<bot-name>",
            "always_online": false
        }
      },
      "oauth_config": {
        "scopes": {
            "bot": [
                "channels:join",
                "channels:read",
                "groups:read",
                "chat:write",
                "chat:write.public",
                "files:read",
                "files:write",
                "reactions:read",
                "reactions:write",
                "users:read.email"
            ]
        }
      },
      "settings": {
        "org_deploy_enabled": false,
        "socket_mode_enabled": false,
        "token_rotation_enabled": false
      }
    }

    If you only need to send plain-text or Markdown messages to channels and don't require file attachments, emoji reactions, or Workflow approvals, you can use a smaller scope set to reduce the token's exposure and simplify workspace admin approval.

    Minimal manifest for basic notifications
    {
      "_metadata": {
        "major_version": 2,
        "minor_version": 1
      },
      "display_information": {
        "name": "<app-name>"
      },
      "features": {
        "bot_user": {
            "display_name": "<bot-name>",
            "always_online": false
        }
      },
      "oauth_config": {
        "scopes": {
            "bot": [
                "channels:read",
                "groups:read",
                "chat:write"
            ]
        }
      },
      "settings": {
        "org_deploy_enabled": false,
        "socket_mode_enabled": false,
        "token_rotation_enabled": false
      }
    }

  5. Select Install to Workspace and confirm the permissions. The app should now be available in the Slack Workspace.

For more information about the required Slack scopes, see Required Slack Bot permissions.

4. In Dynatrace: Authorize the connection to Slack

Your Dynatrace Slack Connector requires an OAuth token to authorize sending messages to Slack.

  1. Go to Slack API, select Your Apps in the upper-right corner, and select the app you created.
  2. Go to Features > OAuth & Permissions. If you're a workspace admin, you'll be able to copy the OAuth token for your workspace. Otherwise, you'll need to Request to Install it. After the admin enables your app, you'll also get access to the OAuth token.
  3. Copy the OAuth token.
  4. Return to Dynatrace, go to Settings Settings, and select Connections > Slack.
  5. Select Add Connection, give your Slack connection a name, and paste the OAuth token in Bot token.
  6. Select Create. Your Slack connection now appears in the Connection overview.

5. Enable external approvalsOptional

When no Signing Secret is configured or Allow external approvals is disallowed, the Request Approval action sends an approval link via the Slack message.

To fully use the Request Approval action from Slack Connector:

  1. Edit a Connection by selecting > Edit.
  2. Enable the switch for Accept external approvals.
  3. Go to Slack API, select Your Apps in the upper-right corner, and select the app you created.
  4. Copy the Signing Secret.
  5. Paste the Signing Secret into the Signing Secret field.
  6. Select the Add Generate.
  7. Copy the Webhook URL.
  8. Return to the app in the Slack API page.
  9. Go to Features > Interactivity & Shortcuts.
  10. Enable the interactivity for the app.
  11. Paste the Webhook URL into the Request URL form field.
  12. Return to Dynatrace and select Save to save the Connection.
  13. Go to Settings Settings > General > Workflow approval requests, and select Allow external approvers.

Required Slack Bot permissions

The scopes you need depend on which connector features you use. The following table shows what each scope allows.

Use-caseRequired scopes

Send messages to channels

chat:write, channels:read, groups:read, optionally chat:write.public

Auto-join public channels if the bot is not already a member

channels:join

Upload file attachments with messages

files:write, files:read

Add emoji reactions to messages

reactions:write

Send approval requests to channels

chat:write, channels:read, groups:read, optionally chat:write.public

After adding or changing scopes in Slack API under OAuth & Permissions, reinstall the app to regenerate the bot token with the updated scopes. Then update the token in Dynatrace under Settings > Connections > Connectors > Slack.

Related topics

  • Get started with Slack Connector
Related tags
Dynatrace Platform