Overview

Information

Enad allows you to register for webhook events sent over HTTP.

Supported events

1. Product
2. Variants
3. Tags
4. Categories
5. Markets
6. Store Groups
7. Prices
8. Stocks

Ack deadline

A webhook will be dropped and marked as failure if there is no 200 response within 15 seconds. It will be retried later on.

Events structure

All of our events start with the 2 JSON keys event_type and payload. event_type describes the type of event, and payload is the data.

The event_type is structured as category.type of event.

JSON Example

{
  "event_type": "something.happend",
  "payload": {
    "x": "y"
  }
}

Authentication

We only support authentication using a header key and a header value. These values will be set in the request headers before sending the request.

Header key	Header value
Authorization	Bearer xqwerty12345

The header key is dynamic, meaning it can also be x-api-key or api-key.

Authorization is requried.

Retry policy

We will retry events up to 5 times before considering them a failure.

Use Cases

Some use cases for webhook events are:

1. Revalidate frontend.
2. Stock and price updates in external systems.
3. Product information updates in external systems.
4. Alerts

Managing events

Register a webhook by:

1. Logging into Enad Admin.
2. Clicking the app to which you want to add a webhook.
3. Going to System -> Integrations -> Add new integration and following the instructions in the dialog.