Skip to main content

Slack DMs for Your CircleCI Workflows

Learn how to receive Slack direct message notifications for CircleCI workflow runs you trigger, including failed, on hold, and actor-tagged build alerts.

Getting Slack DM Notifications for Your CircleCI Workflows

CircleCI now supports sending Slack direct messages for workflow runs that you trigger. This means you can get real-time build status updates delivered straight to your Slack DMs — no need to watch the CircleCI dashboard or wait for email notifications.

What's included

When enabled, you can receive Slack DM notifications for:

  • Workflows you triggered that have a status of failed, error, or unauthorized on your default branch

  • On hold workflows awaiting approval

  • Actor-tagged notifications (when you're specifically called out in a workflow)

How to set it up

Step 1: Connect your Slack account

Navigate to your CircleCI User Notification Settings and link your Slack user to your CircleCI account.

Step 2: Configure your preferences

In the same notifications settings page, toggle the notification channel to Slack. Click the caret (›) next to My Work to expand and enable or disable specific notification types based on your preferences.

That's it — once linked, CircleCI will send workflow notifications to your Slack DMs automatically.

Requirements

  • Your organization must have the CircleCI Slack App installed in your Slack workspace.

  • You must be the user who triggered the workflow to receive DM notifications for it.

Need help?

If you run into any issues connecting your Slack account or configuring notifications, contact CircleCI Support.

Did this answer your question?