Edit

Share via

Create a Database Mail account

  • Article

Applies to: SQL Server Azure SQL Managed Instance

Use either the Database Mail Configuration Wizard or Transact-SQL 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 SQL Server instance.

  2. In Object Explorer, connect to the SQL Server 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

Create a Database Mail Profile