Skip to content

create-a-database-mail-account.md

Latest commit

 

History

History
91 lines (56 loc) · 3.75 KB

create-a-database-mail-account.md

File metadata and controls

91 lines (56 loc) · 3.75 KB
title Create a Database Mail Account
description Create a Database Mail account.
author WilliamDAssafMSFT
ms.author wiassaf
ms.date 05/16/2025
ms.service sql
ms.topic how-to
helpviewer_keywords
Database Mail [SQL Server], accounts
accounts [Database Mail]
monikerRange >=sql-server-2016 || >=sql-server-linux-2017 || =azuresqldb-mi-current

Create a Database Mail account

[!INCLUDE SQL Server SQL MI]

Use either the Database Mail Configuration Wizard or [!INCLUDEtsql] to create a Database Mail account.

Prerequisites

  • Determine the server name and port number for the Simple Mail Transfer Protocol (SMTP) server you use to send e-mail.If the SMTP server requires authentication, determine the user name and password for the SMTP server.

  • Optionally, you might also specify the type of the server and the port number for the server. The server type is always 'SMTP' for outgoing mail. Most SMTP servers use port 25, the default.

Use Database Mail Configuration Wizard to create a Database Mail account

The following steps use SQL Server Management Studio (SSMS). Download the latest version of SSMS at aka.ms/ssms.

  1. Connect to the [!INCLUDEssNoVersion] instance.

  2. In Object Explorer, connect to the [!INCLUDEssNoVersion] instance you want to configure Database Mail on, and expand the server tree.

  3. Expand the Management node.

  4. Double-click Database Mail and open the Database Mail Configuration Wizard.

  5. On the Select Configuration Task page, select Manage Database Mail accounts and profiles, and select Next.

  6. On the Manage Profiles and Accounts page, select Create a new account and select Next.

  7. On the New Account page, specify the account name, description, mail server information, and authentication type. Select Next.

  8. On the Complete the Wizard page, review the actions to be performed and select Finish to complete creating the new account.

Create a Database Mail account with Transact-SQL

To run T-SQL commands on your SQL Server instance, use SQL Server Management Studio (SSMS), the MSSQL extension for Visual Studio Code, sqlcmd, or your favorite T-SQL querying tool.

Execute the system stored procedure msdb.dbo.sysmail_add_account_sp to create the account and specify the following information:

  1. The name of the account to create.

  2. An optional description of the account.

  3. The e-mail address to show on outgoing e-mail messages.

  4. The display name to show on outgoing e-mail messages.

  5. The server name of the SMTP server.

  6. The user name to use to log on to the SMTP server, if the SMTP server requires authentication.

  7. The password to use to log on to the SMTP server, if the SMTP server requires authentication.

The following example creates a new Database Mail account.

EXECUTE msdb.dbo.sysmail_add_account_sp  
    @account_name = 'AdventureWorks Administrator',  
    @description = 'Mail account for administrative e-mail.',  
    @email_address = 'dba@Adventure-Works.com',  
    @display_name = 'AdventureWorks Automated Mailer',  
    @mailserver_name = 'smtp.Adventure-Works.com' ;

Next step

[!div class="nextstepaction"] Create a Database Mail Profile