Back to Blog
Guide

Jenkins Slack Notification: slackSend Pipeline Tested with a Bot Token

We ran the Jenkins Slack Notification plugin against a real Slack app: the pipeline that worked, the botUser setting that makes slackSend fail with a 404, threads, Block Kit, and the errors for channels the bot cannot see.

Slack Green Team
October 6, 2026
October 6, 2026
4 min read
Share:
slack api
jenkins

To send Slack notifications from a Jenkins pipeline, install the Slack Notification plugin, save a Slack bot token as a Secret text credential, and call slackSend in a post block. If you use a bot token from your own Slack app, set botUser: true. Without it, our first build failed with ERROR: Slack notification failed and a 404 in the Jenkins log. On 6 October 2026 we ran Jenkins 2.580.1 (Docker image jenkins/jenkins:lts-jdk21) with Slack Notification plugin 795.v4b_9705b_e6d47 against a throwaway app in our free-plan test workspace. Everything below comes from those builds.

What you need in Slack

Create a Slack app, add the bot scope chat:write (and chat:write.public if Jenkins should post in public channels without joining them), install it, and copy the Bot User OAuth Token (xoxb-). Our bot token guide shows where Slack keeps it. Invite the bot to every private channel it should post in.

Configure the plugin

In Jenkins, add the token under Manage Jenkins > Credentials as kind Secret text. Then open Manage Jenkins > System > Slack and fill in the workspace (your <name>.slack.com subdomain), the credential, and tick Custom slack app bot user. We set the same values with Configuration as Code:

credentials:
  system:
    domainCredentials:
      - credentials:
          - string:
              scope: GLOBAL
              id: slack-bot
              secret: "${SLACK_BOT_TOKEN}"
unclassified:
  slackNotifier:
    teamDomain: slack-0yr1948
    tokenCredentialId: slack-bot
    botUser: true

The ticked box is botUser: true. We left it false on the first run on purpose.

The botUser trap

With botUser: false and a bot token, slackSend printed this in the console:

Slack Send Pipeline step running, values are - baseUrl: <empty>, teamDomain: slack-0yr1948, channel: #sglab-1006, color: good, botUser: false, tokenCredentialId: slack-bot, ...
ERROR: Slack notification failed. See Jenkins logs for details.

The Jenkins log had Slack post may have failed. Response: null and Response Code: 404. With botUser: false the plugin posts to https://<workspace>.slack.com/services/hooks/jenkins-ci?token=..., the endpoint of Slack's old Jenkins CI app (we found that URL in the plugin's StandardSlackService class). A token from your own app gets a 404 there. With botUser: true it calls chat.postMessage on https://slack.com/api/. The build itself did not fail on that line. It failed on the next one, because slackSend returned null:

java.lang.NullPointerException: Cannot get property 'threadId' on null object

Setting botUser: true (globally, or in each slackSend call) fixed it. The next build posted all three messages.

Never appear "away" on Slack again

Cloud-based. No downloads. Works 24/7 even when your laptop is off.

The pipeline that worked

pipeline {
  agent any
  parameters { booleanParam(name: 'FAIL', defaultValue: false, description: 'force a failure') }
  stages {
    stage('Build') {
      steps {
        echo 'building'
        script { if (params.FAIL) { error('forced failure for the Slack test') } }
      }
    }
  }
  post {
    success {
      script {
        def r = slackSend(channel: '#sglab-1006', color: 'good', botUser: true,
          message: "Build passed: ${env.JOB_NAME} #${env.BUILD_NUMBER} (<${env.BUILD_URL}|open>)")
        echo "threadId=${r.threadId} ts=${r.ts} channelId=${r.channelId}"
        slackSend(channel: r.threadId, botUser: true,
          message: "Deploy step started for #${env.BUILD_NUMBER}")
        def blocks = [
          [type: 'header', text: [type: 'plain_text', text: "Build #${env.BUILD_NUMBER} passed"]],
          [type: 'section', text: [type: 'mrkdwn', text: "*Job:* ${env.JOB_NAME}\n*Branch:* main"]],
          [type: 'actions', elements: [[type: 'button', text: [type: 'plain_text', text: 'Open build'], url: "${env.BUILD_URL}"]]]
        ]
        slackSend(channel: '#sglab-1006', botUser: true, blocks: blocks)
      }
    }
    failure {
      slackSend(channel: '#sglab-1006', color: 'danger', botUser: true,
        message: "Build failed: ${env.JOB_NAME} #${env.BUILD_NUMBER} (<${env.BUILD_URL}console|console>)")
    }
  }
}

The console printed the return value of the first call:

threadId=C0C7T45CQ1W:1791252925.515999 ts=1791252925.515999 channelId=C0C7T45CQ1W

threadId is the channel ID and the message timestamp joined by a colon. Passing it as channel posts a reply in that message's thread. Build #3 ran with FAIL=true and posted the red message from the failure block:

Slack messages from the app sglab1006: Build passed slack-test #2 with a green bar and 1 reply in a thread, a Block Kit message with the header Build #2 passed, Job and Branch fields and an Open build button, and Build failed slack-test #3 with a red bar

color: 'good' and color: 'danger' draw the green and red bar. The plugin sends them as a legacy attachment. In our channel the attachment text was empty in conversations.history, because the message lives in the attachment, so search the attachment if you read these messages back with the API. The Block Kit header showed in bold at the same size as the body text, which is how Slack's web app draws every header block.

Errors for channels the bot cannot use

A second job sent slackSend to channels the bot could not post in, then printed each return value:

channel:Console outputReturn value
A private channel the bot is not inSlack notification failed with exception: {"ok":false,"error":"channel_not_found"}null
A channel that does not existsame channel_not_foundnull
A member ID (U0B7L4YK420)no error, posted as a DM from the botchannel D0C72DQ3D6Y
Private channel with failOnError: truesame error, and the build ended FAILUREnone

Slack answers channel_not_found for a private channel the bot was never invited to, not not_in_channel, so the message looks like a typo even when the name is right. Invite the bot with /invite @your-app in that channel. Without failOnError: true, a failed slackSend does not fail the build; it returns null, and any later r.threadId throws the NullPointerException above. Add failOnError: true if a missing notification should stop the build, or check for null before you use the result. For the other errors Slack can return, see our missing_scope page.

FAQ

Can I use an incoming webhook instead of a bot token?

Yes, from an sh step with curl, as in our webhook curl example. Keep the webhook URL in a Secret text credential and read it with withCredentials. A webhook posts only to its one channel and returns no message timestamp, so you cannot reply in a thread.

How do I mention someone in a Jenkins Slack message?

Put the member ID in the message as <@U0B7L4YK420>; this page shows how to find it. notifyCommitters: true asks the plugin to look up committers by email, which needs the users:read.email scope; we did not test it.

Always Active

Stop Jiggling Your Mouse.

Join hundreds of remote workers who never worry about their Slack status. Set it up once, stay green forever.

Related Articles

Guide

How to Bulk Delete Slack Messages (Tested Script)

The Slack app deletes one message at a time. We ran a script that deleted 120 of our messages in 108 seconds and handled the rate limits.

Slack Green Team
Developers

Slack App Configuration Token: Generate, Rotate and Revoke

An app configuration token lets a script create Slack apps from manifests. We generated one, rotated it five times and tested it again 28 hours later.

Slack Green Team
Developers

Slack App Collaborators: Add, Remove and Transfer Ownership

Collaborators are the people who can edit a Slack app. We added and removed one on 20 November 2026 as a regular member of a test workspace, recorded who can be added and what Slack asks you to do after a removal, and wrote down the hand-over path Slack documents.

Slack Green Team