Event Handlers

External webhooks for receiving notifications from the network

Event Handlers represent remote systems to which events can be sent. Various types of event handlers allow events to be sent to different types of receiver. Once one ore more event handlers has been configured, an Event Map is created which controls which which Event Types are sent to which Event Handler(s).


The default type of Event Handler is a webhook - a remote URL/script which is called using an HTTP POST request. The URL and path is configured in the Event Handler/Webhook configuration - the HTTP payload contains the data specific to the particular type of event (in JSON format).

In addition to the URL (http supported but https recommended), configuration can contain a timeout (in seconds) and authentication data (where required).

Authentication can use a Bearer Token or HTTP Basic Authentication.

If delivery of an event to a webhook fails, it will be retried according to a back-off schedule but then eventually discarded.

In order to preserve the order of events for a particular scope (Endpoint, Routing Target or Customer Account), should event delivery fail, subsequent events will also be delayed too.