---
schema_version: "1"
id: b5727fd81ded66da32cd61a3854ae013bdbddf4ec7994dc8b6bc882ecc0dfd27
title: Configure SMTP OAuth for a Shared Microsoft Mailbox
collection: tableau
version: next
locale: en-us
portal_url: https://docs.salesforce.com/tableau/next/en-us/server/config_smtp_oauth_ms.md
canonical_url: https://help.tableau.com/v0.0/server/en-us/config_smtp_oauth_ms.htm
source_site: help.tableau.com
content_type: documentation
content_hash: 4513c2fd48a60096b5b1f2b0fdd4850c3d0e6d5a1ac1c4b3865bf47cb75d0be1
description: Configure the SMTP server so Tableau Server can email admins and users about alerts and subscriptions.
---
[Skip to main content](#main-content)

# Configure SMTP OAuth for a Shared Microsoft Mailbox

Beginning with Tableau Server version 2025.1.11 you can use SMTP with OAuth to send email to server administrators about system failures, and email server users about subscribed views and data-driven alerts. After configuring SMTP with OAuth, complete the steps to configure notifications ([Configure Server Event Notification](https://help.tableau.com/v0.0/server/en-us/email.htm)), then when you start or restart the server, it will trigger an email notification, which confirms that you have set up notifications correctly.

Configuring SMTP with OAuth requires that you restart Tableau Server services.

## SMTP with OAuth

This example explains how to configure Tableau Server to send email using SMTP configured with OAuth (client credentials) on behalf of a Microsoft 365 shared mailbox.

Disclaimer: This documentation includes a brief overview of the external configuration steps necessary but focuses on the configuration in Tableau Server. You are responsible for configuring the external, shared mailbox correctly. You can find detailed instructions in the [Microsoft documentation](https://learn.microsoft.com/en-us/exchange/client-developer/legacy-protocols/how-to-authenticate-an-imap-pop-smtp-application-by-using-oauth#add-the-pop-imap-or-smtp-permissions-to-your-microsoft-entra-application "Authenticate an IMAP, POP, SMTP application by using OAuth").

### External steps in Microsoft to configure SMTP with OAuth

The external configuration steps you need to perform may include some or all of these:

1. Registering an app in Microsoft Entra. Steps include creating an app registration, adding API permissions, and creating a client secret:
2. Installing any required PowerShell Modules and connecting.
3. Getting the Entra app Service Principal.
4. Creating an Exchange Online Service Principal.
5. Creating a shared mailbox (if one does not exist).
6. Assigning permissions to the app: Full Access (optional) and Send As (required).
7. Enabling SMTP Auth.

### Configure Tableau Server for SMTP OAuth with Microsoft Office 365

1. Enable OAuth on Tableau Server:
    
    tsm configuration set -k svcmonitor.notification.smtp.microsoftoauth.enabled -v true
    tsm configuration set -k svcmonitor.notification.smtp.microsoftoauth.oauth\_feature\_enabled -v true
2. Configure SMTP:
    
    tsm configuration set -k svcmonitor.notification.smtp.server -v smtp.office365.com
    tsm configuration set -k svcmonitor.notification.smtp.ssl\_enabled -v true
3. Configure client credentials:
    
    tsm configuration set -k svcmonitor.notification.smtp.microsoftoauth.api\_host -v login.microsoftonline.com
    tsm configuration set -k svcmonitor.notification.smtp.microsoftoauth.api\_endpoint -v /oauth2/v2.0/token
    tsm configuration set -k svcmonitor.notification.smtp.microsoftoauth.scope -v https://outlook.office365.com/.default
    tsm configuration set -k svcmonitor.notification.smtp.microsoftoauth.tenant\_id -v \[TENANT\_ID\]
    tsm configuration set -k svcmonitor.notification.smtp.microsoftoauth.client\_id -v \[CLIENT\_ID\]
    tsm configuration set -k svcmonitor.notification.smtp.microsoftoauth.client\_secret -v \[CLIENT\_SECRET\]
    tsm configuration set -k svcmonitor.notification.smtp.from\_address -v \[SHARED\_MAILBOX\_ID\]
    tsm configuration set -k svcmonitor.notification.smtp.send\_account -v \[SHARED\_MAILBOX\_ID\]
4. Run the `tsm pending-changes apply` command to apply the changes. See [tsm pending-changes apply](https://help.tableau.com/v0.0/server/en-us/cli_pending-changes.htm#pending-changes-apply).
5. Run the `tsm email test-smtp-connection` to view and verify the connection configuration. See [tsm email test-smtp-connection](https://help.tableau.com/v0.0/server/en-us/cli_email.htm#tsm).