Slack workspace

The Slack Workspace notification service in Buildkite lets you receive notifications about your builds in your Slack workspace.

Adding a Slack workspace notification service will authorize access for your entire Slack app. You only need to set up this integration once for the workspace. You can then configure notifications using YAML to be sent to any Slack channels.

Setting up a Workspace requires Buildkite organization admin access.

Adding a workspace notification service

Screenshot of the 'Add' button for adding a Slack workspace service to Buildkite

Click the Add to Slack button:

Screenshot of 'Add Slack workspace service' screen on Buildkite. It shows an 'Add to Slack workspace' button

This will take you to Slack. Log in, and grant Buildkite the ability to post across your workspace. Once you have granted access, you can then use the notify attribute to edit the YAML of your pipelines and configure notifications.

notify:
  - slack:
      channels:
        - "buildkite-community#general"
        - "buildkite-community#announcements"

Configuring notifications

Mentions in build notifications

Mentions occur when there's a corresponding Slack account using one of the emails connected to the Buildkite account that triggered a build.

Provide the Slack user ID, which you can access via User > More options > Copy member ID.

notify:
  - slack: "U123ABC456"

Notify in private channels

You can notify individuals in private channels by inviting the Buildkite Builds Slack App into the channel with /add Buildkite Builds.

Build-level notifications:

notify:
  # Notify private channel
  - slack: "buildkite-community#private-channel"

Conditional notifications

Use the notify YAML attribute in your pipeline.yml file to configure conditional notifications.

See the Slack channel message section of the Notifications guide for the configuration information.

Slack privacy policy

For more details, please checkout the Slack Marketplace privacy policy.