Email Integration Guide

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.

Setting up an email integration

  1. Create a new Service by going to the Configuration menu and selecting Services, then click Add New Service.

    Add Service

  2. 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.

    Add Email Service

  3. 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.

    Copy the integration email

  4. 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:

    Triggered PagerDuty incident

Fine-tuning email integration

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.

Email filters

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.

Email attachments and truncation of emails

PagerDuty strips all attachments from emails and also truncates messages. See Truncation of emails, attachments, email alerts and email size limits for more details.

TLS encrypted emails

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.