Vanilo Cloud Webhooks

In the Admin area it is possible to define Notifications.

Webhook is one type of notification, besides SMS and E-mail.

A webhook is in fact an HTTP call that will be triggered when a certain event happens in the E-commerce system.

To configure a webhook, the following parameters can be set.


Is currently not used for webhooks, leave it empty:



  "url": "",
  "method": "get|post"

No variable substitution occurs.


  "headers": {
    "Auth": "12345",
    "Accept": "application/json"
  "form": {
    "field1": ""
  "payload": {
    "order_id": "",
    "order_number": "",
    "status": ""
  "query": {
    "order_number": ""
  • headers: HTTP headers to be sent along with the request. Works both with POST and GET
  • form: if this field is present, then the request will be sent as form ('application/x-www-form-urlencoded), and the fields will be taken from the values of form. Only works with POST gets ignored with GET
  • payload: The fields to send as JSON. Only with POST
  • query: Optional query fields for GET requests.


Variables can set in {{ order.number }} format. Whitespaces are ignored, so {{order.number}} works as well. Possible values:

  • order.number
  • (the billpayer's email)
  • (the billpayer's name)
  • (along with the price eg. 29.9 €)
  • order.status
  • order.created_at*
  • order.ordered_at*
  • invoice.number
  • invoice.hash
  • invoice.emitted_on*
  • invoice.currency
  • invoice.pdf_url
  • invoice.pdf_base64
  • invoice.operator
  • invoice.remote_id

*: Datetime fields accept an optional format parameter like: {{ order.ordered_at|'j.n.Y H.i' }} which renders to 1.2.2023 16.03. The format string can be anything from here: