Managing Application notifications
You can create notifications to be informed about the following events occurring within the Applications of your choice. Depending on the notification type, you can create one or more notifications of each type.
The following notification types are available:
Notification type | Event that triggers a notification |
---|---|
Campaign-related changes Real-time |
|
Strikethrough pricing updates Real-time |
note Updating a cart item catalog triggers notifications only when the catalog is linked to an Application that has an active campaign with strikethrough rules. note Changes in collections trigger notifications only when the collections are used in active campaigns containing strikethrough rules. note Editing a campaign evaluation tree at the Application level triggers notifications only if a campaign containing strikethrough rules is a part of the campaign evaluation tree. note Changing the campaign evaluation group in the campaign settings triggers notifications only if the campaign is active and contains strikethrough rules. note Editing a custom attribute triggers a notification only when the attribute is used in: note Editing a per-item custom effect triggers a notification only when the effect is referenced in a strikethrough rule of an active campaign. note Changing the name, currency, or time zone setting of an Application in the Application settings triggers a strikethrough notification only if it is referenced in a strikethrough rule of an active campaign. |
Coupon-related changes Real-time |
|
- With Real-time notifications, it can take up to 5 minutes to send updates after a qualifying event occurs.
- To learn about the loyalty-specific notification types, see Managing loyalty notifications.
- Campaign-related changes:
- Two requests are sent for the same notification: One for campaign evaluation tree changes, which occur at the Application level, and another for all other campaign-related events.
- You cannot select which notifications to receive. Notifications are sent for all events and for all campaigns within an Application.
When an update cannot be sent because of server errors (5xx
status codes),
resend attempts are made for a maximum of 5 hours
with more time passing between each attempt.
See Notification Schemas
Creating a campaign notification
Create campaign notifications to receive updates about campaign-related changes.
To create a campaign notification:
- Select the Application for which you want to set up campaign notifications.
- On the left-side menu, click Notifications.
- Click Create Notification > Campaign-related changes.
- In Notification name, type a name for the notification.
- In URL, type the URL where you want to receive notifications.
tip
To add another destination URL, create another notification.
- In Header, type a full HTTP header. For example:
Content-Type: application/json
. - (Optional) Click Add header for each additional header value required by the receiving party, and enter the corresponding headers.
- Review the schemas of the notifications you will receive.
- (Optional) To validate the URL and headers you entered by sending a test request, click Test Notification.
- Click Create Notification.
Creating a strikethrough pricing notification
Create strikethrough pricing notifications to receive updates about strikethrough pricing. When you create a strikethrough pricing notification, it is automatically activated.
Before you create a strikethrough pricing notification:
- Create a cart item catalog and connect it to the Application.
- Create a strikethrough rule in the Application.
You can create only one notification of this type.
To create a strikethrough notification:
- Select the Application for which you want to set up strikethrough pricing notifications.
- On the left-side menu, click Notifications.
- Click Create Notification > Strikethrough pricing updates.
- In Notification name, type a name for the notification.
- In URL, type the destination URL.
- In Header, type a full HTTP header. For example:
Content-Type: application/json
. - (Optional) Click Add header for each additional header value required by the destination URL, and enter the corresponding headers.
- Review the request payload.
note
See the notification schemas.
- (Optional) To validate the URL and headers you entered by sending a test request, click Test Notification.
- Click Create Notification.
Creating a coupon notification
Create coupon notifications to receive updates about coupon-related changes. When you create a coupon notification, it is automatically activated.
You can create only one notification of this type.
To create a coupon notification:
- Select the Application where you want to set up a coupon notification.
- On the left-side menu, click Notifications.
- Click Create Notification > Coupon-related changes.
- In Notification name, type a name for the notification.
- In the Notification sources section,
specify which sources should trigger a notification:
- Campaign Manager: Notify only when coupons are created, updated, or deleted through the Campaign Manager.
- Management API: Notify only when one of the following endpoints is called:
- Rule Engine: Notify only when coupon changes occur
as the result of one of the following coupon-related API effects:
- couponCreated effect
- updateAttribute effect
- In the Request section, specify the details of the webhook request:
- Verb indicates the HTTP request method:
POST
. - In URL, type the URL where you want to receive the notification.
- In Header, type a custom header that describes the request.
- (Optional) Click Add header for each additional header value required by the receiving party, and enter the corresponding headers.
- Verb indicates the HTTP request method:
- Review the schemas of the notifications you will receive.
- (Optional) To validate the URL and headers you entered by sending a test request, click Test Notification.
- Click Create Notification.
Deactivating a notification
To stop receiving updates from a notification, you can deactivate it. You can reactivate the notification at a later time.
Campaign notifications are active by default and cannot be deactivated. To stop receiving updates from a campaign notification, consider deleting it.
To deactivate a notification:
- On the left-side menu of the Application, click Notifications.
- To the right of the notification, toggle Active.
- In the confirmation window, click Deactivate Notification.
To reactivate a notification, follow the above steps, and in the confirmation window, click Activate Notification.
Editing a notification
You can edit the details of a notification at any time.
To edit a notification:
- Select the Application where you want to edit the notification.
- On the left-side menu, click Notifications.
- Click the edit symbol for the notification.
- Edit the required details, and click Save.
Deleting a notification
You can delete a notification to stop being notified about updates through a given route. To stop receiving updates but retain the notification, consider deactivating the notification instead.
To delete a notification:
- Select the Application where you want to delete a notification.
- On the left-side menu, click Notifications.
- Click next to the notification.
- In the confirmation pop-up that appears, click Delete Notification.