This guide describes how to integrate with PagerDuty any service capable of sending email alerts. Note that we offer integration guides and plugins for many popular monitoring services. Furthermore, tools that don’t yet have dedicated guides can often be configured to work with PagerDuty by using our Integration API.
Create a new Service by going to the Configuration menu and selecting Services, then click Add New Service.
Enter a Name for your new service, select Integrate via email, then set your desired Integration Email address. Choose an Escalation Policy to use when the service receives an email alert, as well as the desired Notification Urgency for incidents (available only with Basic or higher plans). Click Add Service when you are finished.
Note: An integration email address is generated for you at the bottom, but you can change it to anything you like.
Copy the integration email address to your clipboard and point your monitoring system to the integration email address. PagerDuty will open and trigger an incident when it receives an email to this integration address.
You’re done! You just created a PagerDuty service that opens incidents when it receives email. Now you’ll just need to point your monitoring system to the integration email and you’re all set!
Below is a test incident triggered via email:
By default, PagerDuty opens a new incident every time an email is received at the integration address. You can change this behavior by changing the Email Management setting for your service. See How do I control when a new incident is created for my email integration service? for more information.
Filters allow you to disregard certain messages arriving at the integration email address. Each email’s subject, body, and from address can be checked against either a whitelist or blacklist regular expression filter. Messages that don’t pass the filter will be silently discarded. This feature is handy if you have a monitoring tool sends out emails that you don’t want to trigger incidents in PagerDuty. See Setting up regular expression filters in your PagerDuty service for more information on email filters.
PagerDuty strips all attachments from emails and also truncates messages. See Truncation of emails, attachments, email alerts and email size limits for more details.
PagerDuty email servers are configured to accept TLS protected SMTP sessions when your outbound mail servers are configured to use TLS opportunistically. When the message is encrypted, the last hop listed in the receive headers will mention a TLS-enabled connection.