---
title: Configuring email notifications
description: Configure PingID to send an email notification to the user each time a new device is paired to ensure users are aware of every attempt to pair a device with their account and to enable them to report suspected fraud.
component: pingid
page_id: pingid:pingid_service_management:pid_configuring_email_notifications
canonical_url: http://docs.pingidentity.com/pingid/pingid_service_management/pid_configuring_email_notifications.html
revdate: January 23, 2024
section_ids:
  how-to-report-fraud: How to report fraud
  how-pingid-receives-the-users-email-address: How PingID receives the user's email address
  configuring-email-notifications: Configuring email notifications
  about-this-task: About this task
  steps: Steps
  result: Result
---

# Configuring email notifications

Configure PingID to send an email notification to the user each time a new device is paired to ensure users are aware of every attempt to pair a device with their account and to enable them to report suspected fraud.

There is a separate email template for each device type. The email templates are customizable and can include elements such as branding or specific text. To customize the email, contact your Ping Identity representative.

The following image is an example of the default email notification template.

![A screen capture of a PingID email, notifying the user of a newly-added authentication device.](_images/jlz1564020541704.png)

## How to report fraud

Notification emails contain a link to report fraud in case the user receives a notification email without having paired a new device.

|   |                                                                                                                                                                                                     |
| - | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|   | * Repeated clicks on the **Report Fraud** link will trigger the Fraud Reported alert, but will not duplicate an entry in the activity log.

* The **Report Fraud** link is valid for up to 30 days. |

Administrators can access the details of devices paired by users through the PingID activity report. For more information, see [Running the PingID activity report](pid_run_activity_report.html). You can filter the report to view only entries that contain **Fraud Reported** in the **Message** column.

## How PingID receives the user's email address

When an authentication activity occurs following the pairing of a device, the PingID server receives the user's most up-to-date email address from your organization's identity provider (IdP) and uses it to send the notification email to the user.

To define email addresses, configure the script variables or parameters, as shown in the following table.

| Email address source    | Reference                                                                                                                                 | Remarks                                                                    |
| ----------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------- |
| RADIUS                  | [PingID RADIUS PCV parameters reference guide](../pingid_integrations/pid_radius_pcv_parameters.html)                                     | In the General Parameters table, see **Multiple Attributes Mapping Rules** |
| PingID API              | [PingID API - AddUser](https://apidocs.pingidentity.com/pingid-api/guide/pingid-api/pid_c_PingIDapiUserManagement/#AddUser)               | See AddUser                                                                |
| AD FS                   | [Configuring advanced settings](../pingid_integrations/pid_configuring_advanced_settings.html)                                            | See **Email Attribute** in step 5.                                         |
| Azure AD                | [Configuring PingID MFA for Microsoft Azure AD Conditional Access](../pingid_integrations/pid_cfg_azure_conditional_access.html)          | See step 3d.                                                               |
| PingID for PingFederate | [Configuring a PingID adapter instance](../pingid_integrations/configuring_a_pid_adapter_instance.html)                                   | See **Email Attribute** in step 5.                                         |
| PingOne SSO stand alone | [Connecting to an identity repository](http://docs.pingidentity.com/pingoneforenterprise/pingone_for_enterprise/p14e_connecting_idp.html) |                                                                            |

## Configuring email notifications

### About this task

To enable email notifications when a user pairs a new device:

### Steps

1. Sign on to the admin console.

2. Go to **Setup → PingID → Configuration** and go to the **DEVICES** section. ![A screen capture of the Devices section in the Configuration tab.](_images/vmp1584614548177.png)

3. In the **EMAIL NOTIFICATION FOR NEW DEVICES** section, click **Enable**.

4. Click **Save**.

### Result

Users will receive a notification email each time a device is paired with their account or app.