Skip to main content

Get webhook

Retrieves a specific webhook by its unique identifier.

Path Parameters
webhookId uuid REQUIRED

The unique identifier of the webhook.

Responses
200

The webhook associated with the provided identifier.

Schema OPTIONAL
Resource object OPTIONAL

A data model for webhook Registrations

Id uuid OPTIONAL

Webhook Id

Entity int32 OPTIONAL

Possible values: [0, 1, 2, 3, 4, 5, 6, 7, 8, 9]

Type of entity.
0 = NOT_SET
1 = Brand
2 = Capture
3 = Category
4 = Customer
5 = Order
6 = PageWidget
7 = Product
8 = Refund
9 = Supplier

Name string OPTIONAL

Webhook Name

Description string OPTIONAL

Webhook Description

Actions string OPTIONAL

Comma separated list of actions to listen for. Possible actions per entity are:

  • Product, Brand, Category, Supplier - create, update, delete
  • Order - create, update, cancel, activate, lock, complete
  • Capture, Refund - create
  • PageWidget - update, delete
  • Customer - delete, passwordreset, obfuscate
Method string OPTIONAL

Http Method to use

Url string OPTIONAL

Url to send the webhook to. Placeholders can be used to customize the URL.

  • Always available placeholders:
    • {{entity}} - Product, Brand, Category, etc
    • {{action}} - create, update, delete, etc
    • {{account}} - usually the name of your webshop
    • {{environment}} - prod, dev, qa, etc
    • {{id}} -(can be a comma separated list of ids.
  • Partially available placeholders:
    • {{paymentName}} - name of payment method. Only applicable for capture and refund
    • {{channelName}} - name of the channel (web site). Only applicable for capture and refund
    • {{channelUrl}} - url of the channel (web site). Only applicable for password reset
    • {{resetKey}} - key for password reset. Only applicable for password reset
      Note: Not all placeholders are available for all combinations of entities and actions. Ensure that the placeholders you use are relevant to the webhook's entity and action.
Body string OPTIONAL

Body of the webhook. Placeholders can be used to customize the body.

  • Always available placeholders:
    • {{entity}} - Product, Brand, Category, etc
    • {{action}} - create, update, delete, etc
    • {{account}} - usually the name of your webshop
    • {{environment}} - prod, dev, qa, etc
    • {{id}} -(can be a comma separated list of ids.
  • Partially available placeholders:
    • {{paymentName}} - name of payment method. Only applicable for capture and refund
    • {{channelName}} - name of the channel (web site). Only applicable for capture and refund
    • {{channelUrl}} - url of the channel (web site). Only applicable for password reset
    • {{resetKey}} - key for password reset. Only applicable for password reset
      Note: Not all placeholders are available for all combinations of entities and actions. Ensure that the placeholders you use are relevant to the webhook's entity and action.
Headers string OPTIONAL

Headers to send with the webhook

Retry boolean OPTIONAL

True if the webhook should be retried on failure. Retries are attempted up to 3 times with an interval of 10 minutes.

  • Each retry attempt will include a unique HTTP header called x-Idempotency-Key and a timestamp for when the webhook event was initiated. This key serves as an identifier for each specific webhook event and remains the same for all retry attempts of the same webhook event.
  • The primary purpose of the x-Idempotency-Key is to enable the receiving system to identify and handle duplicate webhook events, thus preventing duplicate processing of the same webhook event.
  • The timestamp header is called x-timestamp.
Message string OPTIONAL

A status message for the action taken.

Details string[] OPTIONAL

Any validation messages for the data on the current action.

400

Bad request.

Schema OPTIONAL
Message string OPTIONAL

A status message for the action taken.

Details string[] OPTIONAL

Any validation messages for the data on the current action.

404

Not found.

Schema OPTIONAL
Message string OPTIONAL

A status message for the action taken.

Details string[] OPTIONAL

Any validation messages for the data on the current action.

500

Internal server error.

Schema OPTIONAL
Message string OPTIONAL

A status message for the action taken.

Details string[] OPTIONAL

Any validation messages for the data on the current action.