About the Notifications API

The Notifications API enables you to trigger the sending of predefined notifications to Wix site owners and contributors.

With Notifications, you can trigger notifications that Wix users can receive:

• In the site feed on the Dashboard.
• In the Wix Owner app notification center.
• As a mobile push notification from the Wix Owner app.

Before you begin

It's important to note the following points before starting to code:

• You need to create a notification template in the Wix Dev Center before you can send notifications with the Notifications API. A notification template specifies the text and recipients for notifications. It can include both standard text and placeholders for dynamic values you provide when you send notifications using the Notifications API.
• An app can call the Notify endpoint up to 100,000 times per month for each site.

Sample Use Cases

• Notify a Wix site owner when a customer makes a new room reservation using your app.

Terminology

• Notification template: Specification of standard text, placeholders, and recipients for a particular type of notification. Created in the Wix Dev Center.
• Dynamic values: Text that replaces a notification template's placeholders when sending notifications from your code.
• Notification: An individual message sent to a Wix user by the Notifications API as part of a notification batch.
• Notification batch: All the notifications triggered by a single call to the Notify endpoint.

Creating a Notification Template

Create a notification template in the Wix Dev Center to specify the standard text, placeholders, and recipients of notifications. You can then call the Notify endpoint from your code to trigger sending notifications based on the template you defined.

Accessing notifications in your app's dashboard

1. Sign in to the Wix Dev Center, then click "My Apps" in the navigation menu.

2. Click on the app you want to create a notification template for. This opens the app's dashboard.

3. Click "Notifications" in the sidebar menu. This opens the Notifications page for your app, where you can find all previously defined notification templates.

4. Click "Create Notification". This opens the form for defining a new notification template.

Defining a notification template

Fill out the notification template creation form to define a new notification template, then click "Save" to enable it. The form includes the following sections:

1. Basic info

Give your notification template an internal name and description for managing it in the Wix Dev Center. These are visible only to you.

Choose a name and description that make clear what the notification is about and who receives it. For example, you might choose a name like "New reservation" and a description like "Sent to the site owner when a customer makes a new reservation."

Here you can also find the notification template ID. You need this ID to identify your notification template in API calls.

2. Recipients

Define who receives notifications of this type and where they receive them.

Choose whether all site contributors or only site owners receive notifications.

Choose where recipients receive notifications: in the site feed on the Dashboard, in the Wix Owner mobile app, or in both. Recipients who receive notifications in the mobile app receive push notifications on their mobile device and can see the notifications in the app's notification center.

3. Message

Create the notification content.

If you enable notifications to the mobile app in the Recipients section, a "Title" field appears here. Enter a notification title that recipients will see.

In the "Message" field, enter the text of your notification.

The message and the title can include placeholders for dynamic values you provide each time you send an HTTP request to trigger notifications. For example:

When triggering a notification with the Notify endpoint in your code, you pass values for itemType and customerName, so a recipient sees a customized notification like this:

4. API consumption

Remember your notification template ID and the names of placeholders for dynamic values in your message and title, as you'll need them to invoke the API and trigger notifications. But don't worry if you forget them - you can always return to the Wix Dev Center to look these details up.

Press "Save" to generate your notification template. You can now trigger notifications with the Notify endpoint!

Notifications: Sample Use Cases & Flows

This article shares some possible use cases your app could support, as well as a sample flow that could support each use case. This can be a helpful jumping off point as you plan your app's implementation.

Notify a Wix site owner when a customer makes a new room reservation using your app

When a customer makes a new reservation, notify the Wix site owner with the customer name, room type, and the day of the week.

To notify a Wix site owner:

1. Create a notification template in the Wix Dev Center with the Wix site owner as the recipient.

For example:

Save the given notification template ID and note the dynamic values.

1. A customer makes a new room reservation. For example, Sally Jones reserves the studio for Friday.

2. Pass the given notification template ID and the dynamic values to the Notify endpoint to trigger the notification based on the notification template.

1
{
2
  "notificationTemplateId": "<GIVEN_NOTIFICATION_TEMPLATE_ID>",
3
  "dynamicValues": {
4
    "roomType": {
5
      "text": "studio"
6
    },
7
    "customerName": {
8
      "text": "Sally Jones"
9
    },
10
    "dayOfWeek": {
11
      "text": "Friday"
12
    }
13
  }
14
}

1. The Wix site owner receives the notification defined in the Wix Dev Center: