Skip to main content

Events and Notifications

Zuora

Events and Notifications

The Events and Notifications feature provides capabilities for automatic communications with your customers. Notifications are triggered by standard events, Zuora custom events, custom events, or custom scheduled events. Email notifications are automatically sent to your customers from Zuora's default email server or your own SMTP server, whereas callout notifications send information to a specified web page or URL via an HTTPS call to an external web service. Both types of notifications provide information regarding Zuora standard events, Zuora custom events, custom events, or custom scheduled events.

Supported event types

The following table describes the supported event types in Zuora:

Event type Description Created by Editable?
Standard event

Standard events are pre-defined business events for Zuora Billing, Zuora Payment, Zuora Finance, and Zuora Central Platform.

For more information, see Standard events.

Zuora No
Custom event

You can define a custom event by specifying a base object and trigger condition.

Custom events are triggered when the base object changes and the trigger condition is satisfied, and Zuora will send all notifications associated with the triggered custom event.

For more information, see Custom events.

Tenant users

Yes

For more information, see the following pages:

Zuora custom event

Zuora custom events are pre-defined business events for Zuora Orders and other features.

For more information, see Zuora custom events.

Zuora No
Custom scheduled event

You can define a custom scheduled event by specifying a base object, base field, and scheduled time (hour and minute).

Zuora evaluates notifications associated with custom scheduled events on a daily basis and will send the notification if the date and time meet the custom scheduled event and notification settings.

For more information, see Custom scheduled events.

Tenant users

Yes

For more information, see the following pages:

Manage Notifications

You can create or edit notifications for all event types and resend notification histories through Zuora UI. See Manage Notifications for the details.

In addition, you can use Notifications API to create, query, edit, or delete notifications for all event types and resend notification histories. 

Manage Email Templates

You can use Email templates to manage the content of your email notification. You can create or edit email templates for all event types through Zuora UI. In the email template, you can insert merge field tags into the body to show the account-specific or subscription-specific information in the email notification. See Manage Email Templates and Merge field syntax for email templates for the details.

In addition, you can use Notifications API to create, query, edit, or delete email templates for all event types. 

Configure Callout Notifications

You can create callout notifications for all event types through Zuora UI. See Configure Callout Notifications for the details.

In addition, you can use Notifications API to create, query, edit, or delete callout notifications for all event types. 

Communication Profiles

Communication profiles allow you to send specific event-driven notifications to targeted customer accounts. You can create a new profile and activate the specific notifications in this profile, and then associate this communication profile to the targeted customer accounts. The specific notifications in this profile are sent to your targeted customers when the event occurs.

You can create or edit a communication profile in Zuora UI. See Communication Profiles for the details.

In addition, you can also manage communication profiles through Settings API. See the following tutorials on how to operate on communication profiles through Settings API.

Configure Your Own SMTP Server

You can use your own SMTP server to send out email notifications instead of using Zuora's default email server. The benefits of using your own SMTP server are:

  • More control over emails delivered to your customers because messages are sent through your own server
  • Ability to access sent email records through your SMTP server logs
  • No need to whitelist Zuora email servers because messages are sent through your own server.

See Configure an SMTP Server for Email Notifications for more information.

Reporting on Notifications  

Notification histories based on all event types are available through Data Query, Data Source Exports, and AQuA API to facilitate reporting. Common use cases include:

  • Report on all emails that have failed to be sent, by event, customer name, or date
  • Report on all failed callouts, by event, consumer URL, or date

The history of emails and callouts sent by workflows that have the Customer Notification History setting enabled is also available in the report.

With this enhancement, notification histories can be accessed through the following approaches:

  • Querying one of the following tables through Data Query:
    • notificationhistorycallout
    • notificationhistoryemail
    • notificationhistoryemailevent

      See Available tables for Data Query for more information.

      See Data source availability for a list of all supported data sources.

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:

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 Overview of Multi-Org.

Note

Zuora notification system processes the events in the same order in which they are triggered. The timing and order of callout notifications depend on various factors, such as callout retries, concurrency, and network latency. But Zuora guarantees the best performance possible with the right performance boosters and tuning.