Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Zuora Notifications API

Notifications are the actions taken to inform users or call third-party endpoints when a certain event happens. Typical actions include emails and callouts. Callouts typically refer to HTTP invocations, such as HTTP calls to REST services.**NOTE:** Notifications are processed asynchronously and may be delivered with a delay and out of order.Notifications are associated with Communication Profiles, which allow you to send specific event-driven notifications to targeted customers. Zuora provides the following Settings API to access the settings of Communication Profiles: * [Get all Communication Profiles](https://knowledgecenter.zuora.com/DC_Developers/BB_C_Settings_API/Settings_API_tutorials/Get_all_Communication_Profiles) * [Create a new Communication Profile](https://knowledgecenter.zuora.com/DC_Developers/BB_C_Settings_API/Settings_API_tutorials/Create_a_new_Communication_Profile) * [Modify a Communication Profile](https://knowledgecenter.zuora.com/DC_Developers/BB_C_Settings_API/Settings_API_tutorials/Modify_a_Communication_Profile) * [Get all Notifications under a particular Communication Profile](https://knowledgecenter.zuora.com/DC_Developers/BB_C_Settings_API/Settings_API_tutorials/Get_all_Notifications_under_a_particular_Communication_Profile)

Zuora Notifications API is one of 80 APIs that Zuora publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Notifications. The published artifact set on APIs.io includes an OpenAPI specification.

This API exposes 17 operations across 11 paths, and defines 24 schemas. It is described by OpenAPI 2.0, at version 2023-12-15.

17 operations 11 paths 24 schemas 3 DELETE7 GET5 POST2 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 2.0
API Version
2023-12-15
Resource Areas
1

Paths & Operations 17

Across 11 paths, the API surfaces 17 operations — 3 DELETE, 7 GET, 5 POST, 2 PUT. Each is listed below with its method, path, parameters, and response codes.

Notifications 17

Notifications are the actions taken to inform users or call third-party endpoints when a certain event happens. Typical actions include emails and callouts. Callouts typically ref…

POST
/notifications/notification-definitions
Create a notification definition
POST_Create_Notification_Definition 8 params → 200400404405415500
GET
/notifications/notification-definitions
List notification definitions
GET_Query_Notification_Definitions 11 params → 200404405415500
PUT
/notifications/notification-definitions/{id}
Update a notification definition
PUT_Update_Notification_Definition 8 params → 200400404405415500
GET
/notifications/notification-definitions/{id}
Retrieve a notification definition
GET_Get_Notification_Definition 7 params → 200404405415500
DELETE
/notifications/notification-definitions/{id}
Delete a notification definition
DELETE_Delete_Notification_Definition 7 params → 204400404405415500
POST
/notifications/email-templates
Create an email template
POST_Create_Email_Template 8 params → 200400404405415500
GET
/notifications/email-templates
List email templates
GET_Query_Email_Templates 11 params → 200404405415500
POST
/notifications/email-templates/import
Create or update email templates
POST_CreateOrUpdateEmailTemplates 8 params → 200
PUT
/notifications/email-templates/{id}
Update an email template
PUT_Update_Email_Template 8 params → 200400404405415500
GET
/notifications/email-templates/{id}
Retrieve an email template
GET_Get_Email_Template 7 params → 200400404405415500
DELETE
/notifications/email-templates/{id}
Delete an email template
DELETE_Delete_Email_Template 7 params → 204400404405415500
DELETE
/notifications/history
Delete notification histories for an account
DELETE_Delete_Notification_History_For_Account 7 params → 202400404
GET
/notifications/history/tasks/{id}
Retrieve a notification history deletion task
GET_Get_Notification_History_Deletion_Task 7 params → 200404
POST
/notifications/email-histories/resend
Resend email notifications
POST_ResendEmailNotifications 8 params → 202400
POST
/notifications/callout-histories/resend
Resend callout notifications
POST_ResendCalloutNotifications 8 params → 202400
GET
/v1/notification-history/callout
List callout notification histories
GET_CalloutHistory 14 params → 200
GET
/v1/notification-history/email
List email notification histories
GET_EmailHistory 14 params → 200

Schemas 24

The contract defines 24 schemas that model the data the API accepts and returns. The most detailed are GETPublicEmailTemplateResponse (25 properties), POSTCreateOrUpdateEmailTemplateRequestFormat (21 properties), POSTPublicEmailTemplateRequest (20 properties), GETPublicNotificationDefinitionResponse (18 properties). Each schema is shown below with its type and property counts.

GETEmailHistoryVOType
object
12 properties
ResendEmailNotificationsFailedResponse
object
GETCalloutHistoryVOsType
object
3 properties
POSTCreateOrUpdateEmailTemplateRequest
object
2 properties
PUTPublicNotificationDefinitionRequest
object
11 properties
GETPublicEmailTemplateResponse
object
25 properties
POSTCreateOrUpdateEmailTemplateRequestFormat
object
21 properties 5 required
CalloutMergeFields
object
A key-value map of merge fields of this callout.
GETPublicNotificationDefinitionResponse
object
18 properties
POSTPublicNotificationDefinitionRequest
object
13 properties 2 required
CalloutAuth
object
If requiredAuth is true, this object is required.
4 properties
FilterRuleParameterDefinition
object
Definition of a filter rule parameter.
4 properties
PUTPublicEmailTemplateRequest
object
17 properties
FilterRuleParameterValues
object
The parameter values used to configure the filter rule.
CreateOrUpdateEmailTemplatesResponse
object
1 property
ErrorResponse
object
1 property
ResendCalloutNotificationsFailedResponse
object
NotificationsHistoryDeletionTaskResponse
object
The notification history deletion task information.
6 properties
FilterRuleParameterDefinitions
object
The parameters of the filter rule and their name must match those in the filter rule. And all parameters must be defined in the event type payload. The name of…
POSTPublicEmailTemplateRequest
object
20 properties 5 required
GETEmailHistoryVOsType
object
3 properties
GETCalloutHistoryVOType
object
9 properties
POSTResendEmailNotifications
array
POSTResendCalloutNotifications
array

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

zuora-notifications-api-openapi.yml Raw ↑

Other APIs Zuora publishes across the network.

Zuora V1 API
Zuora Accounting Codes API
Zuora Accounting Periods API
Zuora Accounts API
Zuora Actions API
Zuora Aggregate Queries API
Zuora API Health API
Zuora Attachments API
Zuora Bill Run API
Zuora Bill Run Health API
Zuora Billing Documents API
Zuora Billing Preview Run API