Setting Up Email Alerts

Would you like to be notified of email failures on your WordPress site? With WP Mail SMTP, you can receive various alerts for emails that fail to send from your site.

In this tutorial, we will show you how to set up email alerts on your site with WP Mail SMTP.


Before getting started, you’ll first need to make sure WP Mail SMTP is installed and activated on your WordPress site and that you’ve verified your license.

What Are Email Alerts?

WP Mail SMTP email alerts inform you of email failures on your WordPress site through multiple different services. For example, if your website is unable to send emails, you’ll automatically receive text messages for every failure.

Alerts help catch any misconfigurations in your WP Mail SMTP settings.

Note: If you’re encountering failing emails, check out our troubleshooting guide for WP Mail SMTP.

Setting Up Alerts

To begin setting up email alerts from the WordPress dashboard, go to WP Mail SMTP » Settings and click on the Alerts tab.

Where to find Alerts in WP Mail SMTP Settings

This will take you to the Alerts page where you can select any of these 4 different service integrations to deliver your email alerts:

You’ll need to set up integration with at least one of these services to enable email alerts on your site. In the following sections, we’ll guide you through setting up each service.

Note: We recommend enabling Email Logging on your site to get further information about the errors referenced in each alert.

Email

With the Email option, email alerts are delivered to up to 3 email addresses. These alerts are sent via a secure API and do not rely on your site’s email configuration.

As a result, you’ll still get alerts even if your site cannot send emails.

Unlike the other service integrations, Email notifications will only be sent once every 30 minutes. As a result, if you have multiple failed emails within this period, you’ll only be notified of the first one.

Note: To view all failed emails, you need to enable Email Logging in WP Mail SMTP.

Setting Up Email Integration

To enable email alerts, ensure the Email Alerts option is toggled to the on position.

Email Alerts on

Type the intended recipient address into the Send To field to set an address.

Add an email address

If you’d like to add another address, click the Add Another Email Address button.

Click the Add Another Email Address button

Next, enter the additional email into the second Send To field.

Add another address

When you’re finished setting up email integration, you can either save your settings right away or continue to add other integrations.

Slack

With Slack integration, alerts are sent to your Slack workspaces, or to individual members of your team. Unlike the Email integration, you can have as many Slack configurations as you need. Slack integration utilizes a webhook to facilitate communication.

Setting Up Slack Integration

To use Slack integration, you’ll need to create a Slack app and add its webhook URL to your site. Before doing this, set the Slack Alerts option to the on position.

Slack alerts toggle on

Next, open the Slack API page and create a new app. In the Create an app dialog, choose From scratch to start building your app.

Create a Slack app from scratch

Now you’ll be able to choose an App Name for your Slack app.

Give your Slack app a name

You’ll also need to choose a workspace for your app from the workspace dropdown list.

Select a Slack workspace

Note: Be sure to choose the correct workspace because this setting can’t be changed after your app has been created.

If you’ve chosen the wrong workspace, you’ll need to create your app again.

Once you’ve chosen your workspace, click the Create App button to generate your new Slack app.

Click create app

Once your Slack app is created, you can add both short and long descriptions, an app image, and a background color for the app under Display Information.

We’ve included an example of what a finished description would look like below:

Slack app information filled in

When you’re finished setting up your app as you like, click the Save Changes button at the bottom right of the screen to save your settings.

Save Changes to your Slack app

The next step is to enable and copy the webhook needed to connect your Slack app to WP Mail SMTP on your site.

To do this, click on Features » Incoming Webhooks in the sidebar of the Slack API page.

Incoming webhooks in Slack

The Incoming Webhooks page allows you to manage all incoming webhooks for your app.

Slack incoming webhooks page

To get started, set the Activate Incoming Webhooks toggle to On.

Slack incoming webhooks activated

Next, under Webhook URLs for Your Workspace, click on the Add New Webhook to Workspace button to generate the webhook URL for your app.

Generate a webhook for your Slack app

Since your Slack app will send notifications to a channel or individual, you’ll need to choose the intended recipient from the list of available channels and persons. To do this, click on the dropdown list and choose a channel or individual.

Choose a recipient for your Slack app

Now grant permission to your app by clicking the Allow button.

Click the Allow button

After the operation completes, you’ll be redirected to the Incoming Webhooks page, where you’ll have a new Webhook URL for your app. Copy the Webhook URL from Slack by clicking the Copy button.

Copy Slack webhook URL

Finally, paste the webhook URL you copied from Slack into the Webhook URL field in your WP Mail SMTP Alert settings.

Slack webhook URL added

Once you’re done with this step, either save your settings or continue to add other integrations.

Once everything is set up correctly, you’ll get notifications in Slack whenever your site fails to send an email.

Example alert in Slack

Note: For more information about using webhooks in Slack, check out  Slack’s Incoming Webhooks API documentation.

SMS via Twilio Alerts

With Twilio integration, email alerts can be sent from your site to any mobile device. SMS alerts are sent via your Twilio phone number.

Due to SMS character limits, this service integration cannot provide you with extensive details. Instead, the message you receive will include the title and log number corresponding to the error that triggered the alert.

As with Slack, there is no limit on the number of Twilio connections.

Setting Up Twilio Integration

To set up Twilio integration, ensure that you have the SMS via Twilio Alerts option toggled to the on position.

Twilio/SMS Alerts integration enabled

If you don’t already have a Twilio phone number, you’ll need to create one. To do this, log in to your Twilio account and click the Get a Twilio phone number button.

Get a Twilio phone number

Once your number has been successfully generated, you’re ready to continue setting up Twilio integration on your site.

First, copy your Account SID from the Twilio console.

Copy Twilio Account SID

Then, paste your Account SID into the Twilio Account ID field in WP Mail SMTP.

Twilio Account ID

You’ll also need to copy the Auth Token from the Twilio console.

Copy Twilio Auth Token

Next, paste the Auth Token in the Twilio Auth Token field in WP Mail SMTP.

Twilio token added

Now, copy your Twilio phone number from the Twilio console.

My Twilio phone number

In your Alerts settings in WP Mail SMTP, paste your Twilio phone number in the From Phone Number field.

Paste your Twilio phone number in the From Phone Number field

Finally, add the phone number that will receive alerts in the To Phone Number field.

Add the recipient's phone number

You can now continue to set up other integrations or save your settings.

Note: If you aren’t receiving Twilio SMS alerts after following the setup process, see our FAQ section to help get you on track.

Webhooks

With webhooks integration, your site can send notifications through any service with webhooks support. As with the Slack and Twilio integrations, there’s no limit on the number of webhooks integrations.

Note: Webhooks alerts are sending POST requests with JSON payloads.

Setting Up Webhooks Integration

First, to integrate Webhooks with your site set the Webhook Alerts toggle to the on position.

Webhooks alerts on

Next, copy the Webhook URL from the service you’d like to utilize and place it in the Webhook URL field.

Webhook URL added

If you’d like to add another webhook integration, click Add Another Webhook URL.

Add another webhook URL

Another Webhook URL field will become available.

Adding another webhook integration

To add an additional webhook integration, paste the new webhook URL in the new Webhook URL field.

Second Webhook added

We’ve included the output of an example webhook alert below:

An example webhook alert

Once you’ve finished setting up your webhooks integrations, don’t forget to save your settings.

Saving Your Settings

Once you’ve added the services you’d like to use, you’ll need to save your changes to complete the setup.

To do this, click on the Save Settings button at the bottom left of the interface.
Save your alerts settings

Frequently Asked Questions

Below, we’ve listed some of the most common questions we receive about email alerts.

Why am I unable to receive Twilio SMS alerts?

If you’re not receiving Twilio alerts, first ensure that your Twilio phone number is active. To do this, go to Phone Numbers » Manage » Active Numbers in your Twilio console.

Manage active Twilio numbers

You should see at least one number listed in the Active Numbers list.

Twilio active numbers listed

If your number is active but you are still not receiving alerts, you may be unable to send messages to your region due to your geolocation permissions settings. You’ll need to adjust your geolocation permissions in order to resolve this issue.

From the Twilio console, go to Messaging » Settings » Geo permissions to view your geolocation settings.

Twilio geo permissions

Next, find your country or region and ensure that it has been enabled.

Find your location in Twilio

Note: If you are using a Twilio trial account, you will only be able to send alerts to the numbers that you have verified. Please see Twilio’s documentation on verified numbers for more information.

That’s it! Now you know how to set up Alerts on your site with WP Mail SMTP.

Next, would you like to easily track how emails are performing on your site? Learn more in our complete guide to email reports in WP Mail SMTP.