{"id":10971,"date":"2020-11-13T09:38:07","date_gmt":"2020-11-12T23:38:07","guid":{"rendered":"https:\/\/database.guide\/?p=10971"},"modified":"2020-11-13T10:00:15","modified_gmt":"2020-11-13T00:00:15","slug":"how-to-setup-database-mail-in-sql-server-ssms","status":"publish","type":"post","link":"https:\/\/database.guide\/how-to-setup-database-mail-in-sql-server-ssms\/","title":{"rendered":"How to Setup Database Mail in SQL Server (SSMS)"},"content":{"rendered":"\n

This article shows you how to setup Database Mail for the first time on a new SQL Server installation.<\/p>\n\n\n\n

As with many things SQL Server, you can configure Database Mail via the SSMS<\/a> GUI, or you can do it using T-SQL<\/a> code.<\/p>\n\n\n\n

This article covers the SSMS GUI option. If you’re interested in the T-SQL option, see How to Send Email in SQL Server (T-SQL)<\/a>.<\/p>\n\n\n\n\n\n\n\n

Configure Database Mail<\/h2>\n\n\n\n

The SSMS GUI gives us a nice, friendly wizard that walks us through the process of configuring Database Mail.<\/p>\n\n\n\n

To start the wizard, use the Object Explorer to expand the Management<\/strong> node. Under this node, you should see the Database Mail<\/strong> option.<\/p>\n\n\n\n

Right-click Database Mail<\/strong> to bring up the context menu:<\/p>\n\n\n\n

\"Screenshot<\/figure>\n\n\n\n

Click Configure Database<\/strong> Mail from the context menu.<\/p>\n\n\n\n

This opens a Welcome screen (unless you’ve previously done this and selected the “Skip this page in the future” option):<\/p>\n\n\n\n

\"Screenshot<\/figure>\n\n\n\n

Click Next<\/strong>.<\/p>\n\n\n\n

This brings you to the following window, where you choose what you want to do next:<\/p>\n\n\n\n

\"Screenshot<\/figure>\n\n\n\n

Leave the first option selected and click Next<\/strong>.<\/p>\n\n\n\n

You may get the following prompt, asking if you’d like to enable Database Mail:<\/p>\n\n\n\n

\"Screenshot<\/figure>\n\n\n\n

Click Yes<\/strong>.<\/p>\n\n\n\n

The reason for this dialog box is that, by default, Database Mail is not enabled on a fresh SQL Server install. If you want to use Database Mail, you need to enable it the first time you configure it. <\/p>\n\n\n\n

Therefore, you won’t see this dialog box on any subsequent visits to the Database Mail configuration wizard (unless you’re re-enabling Database Mail after having disabled it). <\/p>\n\n\n\n

Anyway, we should now be on the New Profile screen:<\/p>\n\n\n\n

\"Screenshot<\/figure>\n\n\n\n

The way Database Mail works is, you create one or more profiles, and then add one or more accounts into those profiles.<\/p>\n\n\n\n

This screen allows you to do both.<\/p>\n\n\n\n

So go ahead and enter your profile details at the top, as well as a description, then click Add…<\/strong>. <\/p>\n\n\n\n

This will bring you to the New Account screen:<\/p>\n\n\n\n

\"Screenshot<\/figure>\n\n\n\n

Enter account details as required. You’ll need to specify an outgoing mail server that works, and that you can authenticate against if required. Be sure to use the correct port. Common ports are 25, 465, and 587. <\/p>\n\n\n\n

Click OK<\/strong> once you’ve entered the details.<\/p>\n\n\n\n

This returns you to the Profile screen, except that it’s now called Manage Existing Profile instead of New Profile:<\/p>\n\n\n\n

\"Screenshot<\/figure>\n\n\n\n

You’ll see your mail account in the list of SMTP accounts. You can add more accounts if required. <\/p>\n\n\n\n

One of the benefits of profiles is that, when mail is sent, if one account fails for whatever reason, Database Mail will try the next one listed in the profile, and if that account’s no good, the next one, and so on.<\/p>\n\n\n\n

But for now, click Next ><\/strong>.<\/p>\n\n\n\n

That brings us to the Manage Profile Security screen:<\/p>\n\n\n\n

\"Screenshot<\/figure>\n\n\n\n

In my example I selected Public and Yes in order to make it a the default public profile.<\/p>\n\n\n\n

However, whether you select this option will depend on your circumstances.<\/p>\n\n\n\n

A public profile allows any user with access to the msdb<\/strong> database to send e-mail using that profile. A private profile can be used by a user or by a role. <\/p>\n\n\n\n

Making this the default profile means that, if someone tries to send mail without specifying which profile to use, this profile will be used. However, it will first try to use the default private<\/em> profile for the current user. If the user does not have a default private profile, it will use the default public profile.<\/p>\n\n\n\n

So basically, what we did here was elect this profile to be the backup profile to the backup profile.<\/p>\n\n\n\n

Anyway, once you’ve done whatever you needed to do at this screen (if anything) click Next ><\/strong>.<\/p>\n\n\n\n

Now we get the Configure System Parameters screen:<\/p>\n\n\n\n

\"Screenshot<\/figure>\n\n\n\n

Most of these parameters are reasonably self explanatory. Feel free to change anything you need changed, then click Next ><\/strong>..<\/p>\n\n\n\n

Almost done – it’s the Complete the Wizard screen:<\/p>\n\n\n\n

\"Screenshot<\/figure>\n\n\n\n

If it all looks good, click Finish<\/strong>.<\/p>\n\n\n\n

The wizard finally goes ahead and actually does the configuration. It will go through each step and return its status: <\/p>\n\n\n\n

\"Screenshot<\/figure>\n\n\n\n

Hopefully you’ll see “Success” written all over it like we see here. <\/p>\n\n\n\n

That completes the setup of Database Mail.<\/p>\n\n\n\n

Send a Test Email<\/h2>\n\n\n\n

At this stage, you’ll probably want to send yourself a test email, just to confirm that everything is working OK.<\/p>\n\n\n\n

You can do that back at the Object Explorer by right clicking on Database Mail<\/strong> and clicking Send Test E-mail…<\/strong>.<\/p>\n\n\n\n

\"Screenshot<\/figure>\n\n\n\n

This will launch a dialog box that you can use to enter the recipient email address, as well as a subject and body text (of which Database Mail pre-populates with sample text):<\/p>\n\n\n\n

\"Screenshot<\/figure>\n\n\n\n

Once you’ve entered a recipient and (optionally) the other details, click Send Test E-Mail<\/strong>.<\/p>\n\n\n\n

This results in the following dialog box:<\/p>\n\n\n\n

\"Screenshot<\/figure>\n\n\n\n

Hopefully you will receive the email at the designated email address.<\/p>\n\n\n\n

Note that, just because we set up Database Mail, doesn’t mean that the mail will necessarily be sent. There could be any number of problems between Database Mail, the SMTP mail server, and the receiving mail server. For example, if you didn’t provide the correct authentication for the mail server, the mail won’t be sent.<\/p>\n\n\n\n

You can always take a look at the log file viewer, by right-clicking on Database Mail and selecting View Database Mail Log<\/strong>.<\/p>\n\n\n\n

\"Screenshot<\/figure>\n\n\n\n

Other things you can do is run the following scripts: <\/p>\n\n\n\n