Salesforce Docs Portal

Get Started with Event Notification Service

To begin using Event Notification Service (ENS), complete the prerequisites, and then configure your system to receive notifications.

Prerequisites

Set up your development environment to use Marketing Cloud Engagement APIs. Next, in Installed Packages, create an API integration to get a client ID and client secret. Use these permission settings for the API integration:

  • Event Notifications | Callbacks: Read, Create, Update, Delete
  • Event Notifications | Subscriptions: Read, Create, Update, Delete

important: Store your client ID and secret securely. Never hard-code these values into your apps or integrations.

Set Up the Event Notification Service API

  1. Supply an HTTPS callback URL, also known as a webhook, for your application.

  2. Register and verify your callback URL.

  3. Create a subscription that requests notification events.

    A subscription indicates which event types to receive notifications for and which callback URL to receive them on.

  4. Prepare your system for the possibility of receiving a notification event more than one time.

    ENS delivers notifications at least one time per event.

To stop receiving notifications, pause the subscription. If you resume the subscription, ENS delivers only the event notifications that are generated after you resumed the subscription.

Related Items