Job notifications

Set up notifications in dbt platform to receive alerts about the outcome of a job run. You can choose to be notified by one or more of the following job run outcomes:

• Succeeds option — A job run completed successfully with no warnings or errors.
• Warns option — A job run encountered warnings from data tests or source freshness checks.
  • This notification is triggered by warning-level log lines from those steps, not the job's overall run status. A job that shows "success" in the user interface can still trigger a warn notification if test or freshness steps logged warnings.
• Fails option — A job run failed to complete.
• Is canceled option — A job run is canceled.

Notification options

dbt platform currently supports the following notification channels:

• Email
• Slack (user-linked)
• Slack (account-level)
• Microsoft Teams

Microsoft Teams

If you can’t use the native Microsoft Teams integration, you can still send job notifications to a Teams channel by using the channel’s email address as an external email, as explained in the next section.

Email notifications

You can receive email alerts about jobs by configuring the dbt email notification settings.

Prerequisites

• You must be either a developer user or an account admin to configure email notifications in dbt. For more details, refer to Users and licenses.
  • As a developer user, you can set up email notifications for yourself.
  • As an account admin, you can set up notifications for yourself and other team members.

Configure email notifications

1. Select your profile icon and then click Notification settings.

2. By default, dbt sends notifications to the email address that's in your User profile page.

   If you're an account admin, you can choose a different email address to receive notifications:

   1. Under Job notifications, click the Notification email dropdown.
   2. Select another address from the list. The list includes Internal Users with access to the account and External Emails that have been added.
   3. To add an external email address, click the Notification email dropdown
   4. Click Add external email.
   5. Enter the email address, and click Add user. After adding an external email, it becomes available for selection in the Notification email dropdown list. External emails can be addresses that are outside of your dbt account and also for third-party integrations like channels in Microsoft Teams and PagerDuty email integration.
      note

      External emails and their notification settings persist until edited or removed even if you remove the admin who added them from the account.

   Example of the Notification email dropdown

3. Select the Environment for the jobs you want to receive notifications about from the dropdown.

4. Click Edit to configure the email notification settings. Choose one or more of the run statuses for each job you want to receive notifications about.

5. When you're done with the settings, click Save.

   As an account admin, you can add more email recipients by choosing another Notification email from the dropdown, Edit the job notification settings, and Save the changes.

   To set up alerts on jobs from a different environment, select another Environment from the dropdown, Edit those job notification settings, and Save the changes.

   Example of the Email notifications page

Unsubscribe from email notifications

1. Select your profile icon and click on Notification settings.
2. On the Email notifications page, click Unsubscribe from all email notifications.

Send job notifications to a Microsoft Teams channel (email)

You can send dbt job notification emails directly to a Microsoft Teams channel by using the channel’s email address.

1. In Microsoft Teams, get the email address for the channel you want to send notifications to. See Send an email to a channel.
2. In dbt platform, click on your profile in the left sidebar and then click Notification settings.
3. Under Job notifications, click the Notification email dropdown.
4. To add an external email address, click Add external email at the bottom of the dropdown.
5. Enter the Teams channel email address, and click Add user.
6. Make sure you select the Teams channel email from the Notification email dropdown (it might be selected already).
7. Then choose the environment for the jobs you want to receive notifications from.
8. Click Edit, select the job statuses you want. Then click Save to save.

Slack notifications (user)

You can receive Slack alerts about jobs by setting up the Slack integration and then configuring the dbt Slack notification settings. dbt integrates with Slack via OAuth to ensure secure authentication.

This is the current Slack integration available for all users and set at the user level, not to be confused with the Slack notifications at the account level feature.

note

Virtual Private Cloud (VPC) admins must contact support to complete the Slack integration.

If there has been a change in user roles or Slack permissions where you no longer have access to edit a configured Slack channel, please contact support for assistance.

Prerequisites

• You have a Slack workspace that you want to receive job notifications from.
• You must be a Slack Workspace Owner.
• You must be an account admin to configure Slack notifications in dbt. For more details, refer to Users and licenses.
• The integration only supports public channels in the Slack workspace.

Set up the Slack integration

1. Select Account settings and then select Integrations from the left sidebar.
2. Locate the OAuth section with the Slack application and click Link.
   Link for the Slack app

Logged in to Slack

If you're already logged in to Slack, the handshake only requires allowing the app access. If you're a member of multiple workspaces, you can select the appropriate workspace from the dropdown menu in the upper right corner.

Allow dbt access to Slack

Logged out

If you're logged out or the Slack app/website is closed, you must authenticate before completing the integration.

1. Complete the field defining the Slack workspace you want to integrate with dbt.
   Define the workspace
2. Sign in with an existing identity or use the email address and password.
3. Once you have authenticated successfully, accept the permissions.
   Allow dbt access to Slack

Configure Slack notifications

1. Select your profile icon and then click on Notification settings.

2. Select Slack notifications in the left sidebar.

3. Select the Notification channel you want to receive the job run notifications from the dropdown.

   Example of the Notification channel dropdown

4. Select the Environment for the jobs you want to receive notifications about from the dropdown.

5. Click Edit to configure the Slack notification settings. Choose one or more of the run statuses for each job you want to receive notifications about.

6. When you're done with the settings, click Save.

   To send alerts to another Slack channel, select another Notification channel from the dropdown, Edit those job notification settings, and Save the changes.

   To set up alerts on jobs from a different environment, select another Environment from the dropdown, Edit those job notification settings, and Save the changes.

   Example of the Slack notifications page

Disable the Slack integration

1. Select Account settings and on the Integrations page, scroll to the OAuth section.
2. Click the X icon (on the far right of the Slack integration) and click Unlink. Channels that you configured will no longer receive Slack notifications. This is not an account-wide action. Channels configured by other account admins will continue to receive Slack notifications if they still have active Slack integrations. To migrate ownership of a Slack channel notification configuration, have another account admin edit their configuration.

Slack notifications (account)

Integrate Slack with dbt platform at the account level to receive job notifications in Slack. dbt integrates with Slack via OAuth to ensure secure authentication.

A single dbt platform account can integrate with one Slack workspace.

Prerequisites

• You have a Slack workspace that you want to receive job notifications from.
• A dbt platform account admin must link the Slack app at the account level.
• Install the official dbt platform Slack app using the steps outlined in the next section.
• To install the Slack app to a workspace, your Slack org must permit app installations. In some orgs this requires a Slack admin approval.
• The integration only supports public channels in the Slack workspace.

After an account admin links the Slack app for the account, any licensed user in the account can configure Slack job notifications so long as they are assigned to the Account Admin, Owner, or Member default groups. IT licenses don't have access to configure Slack job notifications.

Set up the Slack integration

The account-level Slack integration uses the official dbt platform Slack app, which is separate from the user-linked Slack integration.

To use Slack notifications, you must unlink the old Slack app and then connect the new official app:

1. Go to Account settings > Integrations > OAuth.
2. Click the X icon next to Slack and select Unlink.
3. In the same OAuth section, click Link to connect the official Slack app.

Until you do this, the account-level Slack option will not appear.

Link for the Slack app

Logged in to Slack

If you're already logged in to Slack, the integration only requires allowing the app access. If you're a member of multiple workspaces, you can select the appropriate workspace from the dropdown menu in the upper right corner.

Allow dbt access to Slack

Logged out

If you're logged out or the Slack app/website is closed, you must authenticate before completing the integration.

1. Complete the field defining the Slack workspace you want to integrate with dbt.

   Define the workspace

2. Sign in with an existing identity or use the email address and password.

3. Once you have authenticated successfully, accept the permissions.

   Allow dbt access to Slack

Configure Slack notifications

Configure the Slack channel you want to receive job notifications from.

1. Select your profile icon and then click on Notification settings.
2. Select Slack notifications in the left sidebar.
3. From the first dropdown, select the Notification channel you want to receive the job run notifications.
   Example of the Notification channel dropdown
4. From the second dropdown, select the Environment for the jobs you want to receive notifications about.
5. Click Edit to configure the Slack notification settings. Choose one or more of the run statuses for each job you want to receive notifications about.
6. When you're done with the settings, click Save.
   • To send alerts to another Slack channel, select another Notification channel from the dropdown, Edit those job notification settings, and Save the changes.
   • To set up alerts on jobs from a different environment, select another Environment from the dropdown, Edit those job notification settings, and Save the changes.
   Example of the Slack notifications page

That's it! Your Slack channel is now set up to receive dbt job notifications at the account level. This integration is now available throughout the account for all licensed users.

Migrating legacy Slack notification settings

If you previously configured Slack notifications with the legacy integration, you may see a migration banner on the Slack notifications page.

Example of the Slack migration banner

The banner appears when all of the following are true:

• You have notification settings from a previous Slack integration.
• Your account is connected to the dbt platform app.
• You have not yet configured Slack notifications with the dbt platform app.

Before migrating, you must unlink the legacy Slack integration and link the dbt platform app. Unlinking the legacy integration is a manual step, and only one Slack app can be linked at a time.

The banner appears when all of the following are true:

• You have notification settings from a previous Slack integration.
• Your account is connected to the dbt platform app.
• You have not configured Slack notification settings with the dbt platform app yet.

The dbt platform Slack app sends job notifications to public channels in your workspace. Private channels are different: notifications are not delivered there until you invite the dbt platform app to each private channel you use.

1. Click Migrate settings to copy your existing settings to the dbt platform app, including:

• Your selected Notification channel and Environment
• Your selected jobs
• Your notification toggles (for example, Succeeds, Warns, Fails, and Is canceled)

2. Click Dismiss to hide the banner for your current session — it reappears on reload until migration completes. 3 After migration, if needed, dbt shows an informational message listing private Slack channels that still need setup.

• If any of your channels are private, invite the dbt platform app to each one after migrating so notifications can be delivered.

When migration succeeds, dbt hides the banner and refreshes your Slack notification settings. If migration fails, the banner remains so you can try again.

• Your selected Notification channel
• Your selected Environment
• Your selected jobs
• Your notification toggles (for example, Succeeds, Warns, Fails, and Is canceled)

If any of your notification channels are private, invite the dbt platform app to those channels after migrating, or use the list dbt may show you after migration, so notifications can be delivered.

To migrate your settings:

1. Click Migrate settings to migrate your settings to the dbt platform app.
2. Click Dismiss to hide the banner for your current session. The banner appears again when you reload the page unless migration has completed successfully.

After migration, if needed, dbt shows an informational message listing private Slack channels that still need setup.

Example of private channel invite guidance for the dbt platform app

When migration succeeds, dbt hides the banner and refreshes your Slack notification settings. If migration fails, the banner remains so you can try again.

Disable the Slack integration

In this step, you'll disable the Slack integration and remove the account-level Slack credentials. You can always re-enable the integration by following the Set up the Slack integration steps.

1. Select Account settings and on the Integrations page, scroll to the OAuth section.
2. Click the X icon (on the far right of the Slack integration) and click Unlink.
   • This removes the account-level Slack credentials. All Slack notifications that rely on the account-level integration will stop sending.
   • If any legacy, user-linked Slack integrations still exist, those notifications may continue until the legacy link is removed. We recommend migrating to the new account-level app and removing legacy links.

Microsoft Teams notifications

You can receive Microsoft Teams alerts for your dbt jobs by connecting your Teams account to the dbt platform, and configuring your notification preferences.

dbt integrates with Teams through Microsoft Entra to authenticate securely when you link Teams and configure notification settings.

Prerequisites

Before you begin:

• You must have a dbt platform account
• You have a Microsoft Teams account that you want to receive job notifications from.
• Make sure you have permission to view the Account integrations and Job notifications pages in dbt platform.

Set up Microsoft Teams

To enable Microsoft Teams job notifications, complete the following sections:

1. Link dbt platform account to Teams — A user-level connection that links an individual dbt platform account (or a dedicated service account) to a Microsoft Teams user profile within your tenant.
2. Configure Teams notifications — Configures which Teams channels receive job notifications.
3. Disable the Teams integration (optional) — Remove or reset the connection between dbt platform and Microsoft Teams.

Link dbt platform account to Teams

info

You can link any Teams user account from your tenant, but we recommend creating a dedicated account just for posting dbt notifications. During the OAuth process, you’ll need to sign in to a Microsoft account to complete the integration.

• If you’re logged into a single Microsoft account, the integration will complete automatically.
• If you’re logged into multiple accounts (or none), you’ll be prompted to select or log in to one.

 Image of the Microsoft account selection popup

Example of the Microsoft account popup

To link your dbt platform account to Microsoft Teams:

1. In dbt platform, go to the Account settings page by clicking on your account name and selecting Account settings.
2. In the left sidebar, select Integrations.
3. Scroll to the OAuth section.
4. Next to Teams and click on the Link button.
5. After doing this, you’ll either be prompted to choose your Microsoft account before completing the setup, or return directly to the dbt platform with your Teams profile linked.
6. Your dbt platform account is now linked to Microsoft Teams!

dbt will now add the dbt-cloud-integration app to your Microsoft Entra tenant. This app manages authentication requests and permissions securely.

Example of the dbt-cloud-integration app overview

• The current Entra app permissions are:
  • profile
  • openid
  • offline_access
  • Team.ReadBasic.All
  • TeamsActivity.Send
  • ChannelMessage.Send
  • ChannelMessage.Read.All
  • Channel.ReadBasic.All

Configure Teams notifications

Once you’ve connected dbt platform and Teams, you can configure which Teams channels receive job notifications. The Teams notifications menu requires that you have an active integration with Teams on the account.

info

Currently, dbt only sends notifications to Teams channels (standard, shared, or private) that you belong to.

1. In the dbt platform, click your profile icon and select Notification settings.
2. Select Teams notifications in the left sidebar.
3. From the first dropdown, select the Notification team that you want to send notifications to.
4. From the second dropdown, select the Notification channel you want to send notifications to.
   • dbt platform only sends notifications to Teams channels (standard, shared, or private) that you belong to.
5. In the dropdown, choose the environment for the jobs you want to receive notifications about.
6. Click Edit on the top right to configure the Teams job notification settings and customize which job statuses trigger job notifications.
7. When finished, click Save.

Your Teams channel is now set up to receive dbt job notifications!

Example of the configure Teams notification page

Disable the Teams integration

Disabling and unlinking the Teams integration in the dbt platform removes it for the entire account. To disable it:

1. In the dbt platform, go to Account settings.
2. Click on Integrations and scroll down to OAuth.
3. On the far right of the Teams integration, click the X icon.
4. Confirm the unlinking by selecting Unlink.

The Teams integration has been disabled. You can always re-enable the integration by following the Set up Microsoft Teams steps.

Was this page helpful?

Privacy policyCreate a GitHub issue

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.