Subscription to Events

You can subscribe to domain events by establishing a connection between the application and an external URL to which notifications will be sent whenever the selected event occurs on products or in quotes. The purpose of this feature is notifying clients, or whoever has access to the provided URL, about specific actions performed on products or in quotes. It can be accessed in Setup > Providers > Subscription to Events.

To gain access to this feature, you need to explicitly request it from your system administrator.

There are several domain events that can be triggered in SAP CPQ.

Domain events tied to products:

  • ProductAdded - triggered when a product is added to SAP CPQ.
  • ProductUpdated - triggered when a product is updated in SAP CPQ.
  • ProductRemoved - triggered when a product is removed from SAP CPQ.

These events are triggered when a product is added, updated or removed via API calls for products, in Setup sections: Bulk Import/Export, Product Import, Deploy/Send Changes, Products, Products 2.0 and the Manage Simple Products option in the User Menu.

Domain event tied to quotes:

  • QuoteProvisioned - triggered when the Place Order action is taken on Quote 2.0.

Setting up Subscription to Events

Once you are on the Settings > Providers > Subscription to Events page, you can see the list of existing subscriptions to events. They are divided into several columns:

  • Edit - this column contains the cpq_1908_subscription_to_events_edit_button.jpg and cpq_1908_subscription_to_events_delete_buttons.jpg buttons.
  • Name - this column contains descriptions for each of the listed subscriptions.
  • Description - this column contains descriptions for each of the listed subscriptions.
  • Webhook URL - this column contains URLs to which the notifications are sent once the events are triggered.
  • Event name - this column contains names of the events to which you subscribe.

In order to create subscriptions to events, that is, to establish a connection between a triggered event and an external URL, follow the steps provided below. Once you create a subscription, notifications will be sent to the specified external URL whenever the events occur:

  1. Go to Setup > Providers > Subscription to Events.
    The page in which the existing domain events are listed displays.
  2. Click Add new Subscription to Event.
    The page for adding a new subscription to events displays.
  3. Enter the name of the subscription in the Name (required) field.
  4. Apply the Use for Subscription Billing products toggle switch in order to subscribe to events tied to products which use the subscription billing pricing mechanism (relevant for product domain events only)
  5. (Optional) Add a description for the subscription in the Description field.
  6. Enter the URL to which you want notifications to be sent whenever the event is triggered in the Webhook URL (required) field.
  7. Select the HTTP method for sending requests whenever the event is triggered in the Webhook HTTP method (required) dropdown.
    You can choose between GET, POST, PUT PATCH and DELETE.
  8. Choose the event you wish to subscribe to from the Event name (required) dropdown.
  9. Choose the authentication type you wish to use from the Authentication type (required) dropdown.
    You can choose between Basic and OAuth authentication methods.
  10. Enter the URL which will be used for authentication in the Authentication URL (required) field.
  11. Select the HTTP method which will be used for authentication from the Authentication HTTP method (required) dropdown.
    You can choose between GET and POST.
  12. If you selected Basic authentication type in the Authentication type (required) dropdown, enter your username and password in the indicated fields.
  13. If you selected OAuth authentication type in the Authentication type (required) dropdown, enter the client ID and client secret in the indicated fields.
  14. Click Save if you wish to save the subscription and remain on the page.
  15. Click Save & Go Back if you wish to go back to the page with listed domain events.
    Once you are on the Subscription to Events page, you can also edit or delete subscriptions to events by clicking cpq_1908_subscription_to_events_edit_button.jpg or cpq_1908_subscription_to_events_delete_buttons.jpg buttons.


You can filter the existing subscriptions to events by writing their names, webhooks or related actions in the intended textbox located above the listed subscriptions. The corresponding subscriptions will be listed as soon as you finish typing one of these pieces of information.

You can also edit the Display Settings by clicking the cpq_1908_subscription_to_events_display_settings_button.jpg button. Once you do, you will be offered a list of columns which are displayed in the Subscription to Events page. You can select which columns you wish to be displayed by clicking checkboxes next to them. Once you select all the checkboxes you wish to keep, click Save.

You are here: SAP CPQ Online HelpAdmin Page HelpSubscription to Events