Report on notification histories
Zuora generates a notification history object when an email or callout notification is triggered, capturing the status and relevant details. You can view or resend notification histories, and query these histories through various methods, such as Data Source Export, Data Query, and AQuA API.
View notification histories
Zuora provides various methods for viewing notification histories:
-
You can view all notification histories on the Setup Profiles, Notifications and Email Templates page. For more information, see View notification histories.
-
You can view notification histories sent to a specific account on the account detail page.
-
You can view notification histories with advanced settings by leveraging Data Source Export, Data Query, AQuA API, or Reporting. See the following sections for details.
Query notification histories through Data Source Export
You can create data source exports for the following data sources to query email or callout notification histories:
-
Notification History - Callout
-
Notification History - Email
Query notification histories through Data Query
Notification histories are stored in the following tables that can be retrieved through Data Query:
-
notificationhistorycallout -
notificationhistoryemail -
notificationhistoryemailevent
For more information about each table, see Available tables for Data Query.
Query notification histories through AQuA API
Notification histories are stored in the following objects that can be retrieved through the AQuA API:
-
CalloutHistory
-
EmailHistory
Create a report using the information from notification histories
You can create a summary or detail report against the following data sources for notification histories:
-
Notification History - Callout
-
Notification History - Email
Resend notification histories
Zuora provides various methods for resending notification histories:
-
You can resend any notification history on the Setup Profiles, Notifications and Email Templates page. For more information, see Resend a notification history.
-
You can resend notification histories sent to a specific account on the account detail page.
-
You can use the following operations to resend notification histories through the REST API:
When resending callout or email notifications, some information in the notification to be resent comes from the template associated with the notification definition, while other information comes from the notification history.
The following table describes where the information comes from when resending callout or email notifications:
|
Notification type |
Information from the related template |
Information from the notification history |
|---|---|---|
|
Callout |
|
All other information such as endpoint and custom callout header configurations. |
|
|
|
All other information such as email subject and body. |
Notification histories in Multi-Org enabled tenants
If you have the Multi-Org feature enabled, you can view or resend callout and email notification histories only if they belong to the Org Units you have access to.
This restriction applies when viewing or resending notification histories via the following features and services:
-
Email History & Callout History tabs in the Zuora UI
-
Data Query
-
Data Source Exports
-
Reporting
-
AQuA
-
Resend callout notifications & Resend email notifications API operations
If you have access to more than one Org Unit, you can use the Org Context Switcher to toggle access for notification histories across different Org Units. For more information, see Multi-Org overview.