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.

Notification type	Event that triggers a notification
Campaign-related changes	A campaign was: Created Edited, including changes made to: Mandatory attributes Settings section of any campaign Deleted The state of a campaign changed. One or more rules changed. The evaluation for one or more campaigns changed.
Strikethrough pricing updates	An item was added to a cart item catalog. An item was updated in a cart item catalog. The state of a campaign changed: active to disabled disabled to active scheduled to active A rule or cart item filter was updated. A campaign expired. Data was imported into a collection.
Coupon-related changes	A coupon was: Created Edited Deleted

note

• After a qualifying event occurs, a notification can take up to 5 minutes to be sent.
• 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.

See Notification Schemas

Creating campaign notifications

Create campaign notifications to receive notifications about campaign-related changes.

To create a campaign notification:

1. Select the Application where you want to set up campaign notifications.
2. On the left-side menu, click Settings > Campaign Notifications.
3. Click Set Up Notification if you have not created any yet.
   note

   If there are one or more notifications in the selected Application, click Add a new URL to create more. It allows you to be notified through different routes at the same time.

4. In the New notification pop-up, in URL, type the URL where you want to receive notifications.
5. In Header-Name, type an HTTP header.
6. (Optional) Click Add header for each additional header value required by the receiving party, and enter the corresponding headers.
7. Click Save.
8. Review the schemas of the notifications you will receive and parse them as required.

Creating strikethrough pricing notifications

Create strikethrough pricing notifications to receive updates about strikethrough pricing.

To create a strikethrough notification:

1. Select the Application for which you want to set up strikethrough pricing notifications.
2. On the left-side menu, click Notifications.
3. Click Create Notification > Strikethrough pricing updates.
4. In Notification name, type a name for the notification.
5. In URL, type the destination URL.
6. In Header, type a full HTTP header. For example: Content-Type: application/json.
7. (Optional) Click Add header for each additional header value required by the destination URL, and enter the corresponding headers.
8. Click Create Notification.
9. Review the schemas of the notifications you will receive and parse them as required.

Creating coupon notifications

Create coupon notifications to receive notifications about coupon-related changes.

important

You can create only one notification of this type.

To create a coupon notification:

1. Select the Application where you want to set up a coupon notification.
2. On the left-side menu, click Notifications.
3. Click Create Notification > Coupon-related changes.
4. In Notification name, type a name for the notification.
5. 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:
     • Create coupons
     • Create coupons for multiple recipients
     • Create coupons asynchronously
     • Update coupon
     • Update coupons
     • Delete coupon
     • Delete coupons
   • Rule Engine: Notify only when coupon changes occur as the result of one of the following coupon-related API effects:
     • couponCreated effect
     • updateAttribute effect
6. 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.
7. Review the schemas of the notifications you will receive.
8. Click Create Notification.

Editing notifications

You can edit the details of a notification at any time.

To edit a notification:

1. Select the Application where you want to edit the notification.
2. On the left-side menu, click Notifications.
   note

   To edit a campaign notification, on the left-side menu, click Settings > Campaign Notifications.

3. Click the edit symbol for the notification.
4. Edit the required details, and click Save.

Deleting notifications

You can delete a notification to stop being notified about updates through a given route.

To delete a notification:

1. Select the Application where you want to delete a notification.
2. On the left-side menu, click Notifications.
   note

   To delete a campaign notification, on the left-side menu, click Settings > Campaign Notifications.

3. Click next to the notification.
4. In the confirmation pop-up that appears, click Delete Notification.
   note

   To delete a campaign notification, in the confirmation pop-up that appears, click Delete.

See Notification Schemas

Related pages

• Scheduling campaigns
• Managing campaigns
• Understanding campaign evaluation
• Notification schemas
• Managing loyalty notifications