Configure Slack Notifications

Configuring notifications with Slack® allows you to receive notifications in your Slack channels when events occur within WHMCS.

This module is available for all self-hosted WHMCS installations and for WHMCS Cloud’s Growth and Expansion plans.

Configuring Slack Notifications

To enable WHMCS to communicate with the Slack API, WHMCS requires an OAuth Access Token.

To configure notifications through Slack:

1. Create a Slack app.

Log in to your Slack Workspace and go to https://api.slack.com/apps.

Create a new Slack app:

  1. Click Create New app. You will need to log in if you haven’t already.
  2. Select From scratch.
  3. Enter a name for the app (for example, WHMCS).
  4. Choose the workspace you wish to add the app to and click Create APP.
  5. Select OAuth & Permissions.
  6. Scroll to Scopes: Bot Token Scopes.
  7. Click Add an OAuth Scope and assign the following permissions:
    • channels:join
    • channels:read
    • chat:write
    • groups:read
  8. Scroll up and click Install to [Workspace Name], where Workspace Name is the name of your Slack workspace.
  9. On the OAuth consent screen, click Allow.

2. Copy the app access token.

Copy the Bot User OAuth Access Token value. You will need this to enter in WHMCS.

3. Go to your notification settings.

In WHMCS, to go Configuration () > System Settings > Notifications.

Under the Slack notification provider, click Configure.

4. Paste the access token into WHMCS.

Paste the Bot User OAuth Access Token that you copied into OAuth Access Token.

Adding the token for a Slack app.

5. Save your changes.

Click Save Changes. WHMCS will attempt to verify the access token.

  • If verification fails you will receive an error message. Check whether you entered the access token correctly, verify that it has all the required scopes, and try again.
  • If verification succeeds, the window will close.

6. Create notification rules.

Create the desired notification rules. WHMCS will automatically join your Slack channel when you define it in a notification rule.

For more information, see Notifications.

Private Channels

To send notifications in private channels:

  1. Open the Slack app.
  2. Go to your private channel.
  3. Invite the app to the channel with the following command:
    /invite @app_name
    Replace app_name with the name of your app. For example:
    /invite @WHMCS Test App
  4. Send the message.

The app will join the private channel and become available for selection in WHMCS when creating a notification rule.

notifications slack

Last modified: 2026 June 17