Managing Your Webhooks in the UI

**Configuration Change. ** Version 4.1 and later support managing your webhooks using the UI. Version 4.2 and later add adaptive delivery events.

You can manage your webhooks using the Webhooks API or the Webhooks section in the UI. The UI provides a flexible, easy-to-use interface to view details about your webhooks, create new webhooks, test and update existing webhooks, and delete webhooks you no longer need.

The Webhooks tab displays details about your existing webhooks. The following information is displayed for each webhook:

Name specified when you created the webhook

Status of the webhooks

Pending – No batches yet received for this webhook

OK – All batches within the last 24 hours have been successfully delivered

Failed – At least one batch within the last 24 hours has failed

Target URL to which the data is posted

Event types the webhook will receive

“Webhooks List” shows two example webhooks. The all_events_webhook will receive all event types on yourtargetURL.com; while the message_events_webhook will receive only Delivery, Policy Rejection, and Out-of-Band events on mytargetURL.com.

To create a webhook that meets your specific requirements, you must understand the events being posted to the webhook. Events are categorized as message, generation, or engagement.

Message events describe the life cycle of a message including injection, delivery, and disposition. The following are the available message events:

Engagement events describe the behavior of a recipient with respect to the message sent. The following are the available engagement events:

Click – Recipient clicked a tracked link in a message, thus prompting a redirect through the Momentum click-tracking server to the link’s destination.

Open – Recipient opened a message in a mail client, thus rendering a tracking pixel.

Adaptive delivery events occur when Momentum receives a negative response from an ISP that relates to maintaining a reputable deliverability status. The following are the available adaptive delivery events:

Status – A negative ISP response triggers an adaptive rule, and Momentum took action to adjust its sending patterns.

Adjustment – Momentum changed a low-level parameter as a result of an adaptive rule being triggered or automatic performance tuning.

A batch of event data transmitted to a webhook consists of one or more event records, each composed of a payload wrapped in a type-specific envelope as described for each event type. Each event record payload includes the data fields specific to that event type.

For example, the message_events_webhook is subscribed to "delivery", "policy rejection", and "out-of-band event" types. It’s message event batch includes only that data specific to those events. The following shows an example "delivery" payload.

For the field definitions and a mapping of the fields that constitute a payload for a given event type, use the Webhook Events and Webhook Sample Events endpoints. See the Webhooks API documentation available at Momentum 4 REST API.

Using the UI, you can create webhooks to post data for any of the event types listed above.