Actions

Actions allow you to trigger external resources or workflows via Api webhooks.

You define the URL of an action in the settings of the DataTab. The action gets executed when the value of the DataTab changes or a Button (DataTab with data type 'Button') is pressed.

Unless otherwise defined the action executes a HTTP POST request. You can specify a different HTTP method by adding GET, POST, PATCH, PUT or DELETE in front of the URL (separated with a space) in the DataTab action setting.

Request

The action triggers an HTTP request for the defined URL.

The url must be a valid https url, with a valid certificate. The resource must be accessible from the internet and cannot point to a local resource (e.g. localhost). IP addresses are not allowed. Domains that resolve to a private IP range do not work.

If you have defined credentials for this domain in your account settings, they will be added to the request header.

If multiple credentials are defined, the newest, active will be used.

The body contains the Id of the DataTab the request originates from, the document.

A DataTab used in an instanced layout preserves the same id in all documents created with this layout.

The body also contains the UNIX timestamp (in seconds) of the update.

HTTP GET and DELETE requests do not contain a body.

Example action request:

{
    "dataTab": "dt_e8eRBTcIiDpV7xCVZh9W5",
    "document": "doc_e8eRBY2lVNghZLGQusPiT",
    "value": "The new value",
    "updatedOn": 1775052725
}

Credentials

Go to your account settings and select the "credentials" tab. Here you can add credentials per domain. Just define the domain name. Protocol (e.g. https://), path or an ip address are not supported. Local resources (e.g. localhost) cannot be reached and will return an error.

As credentials define the HTTP header first followed by an equal sign and the header value (e.g. 'Authorization=Bearer my_key_1234567890'). Do not use headers like "Content-Type" or "User-Agent" as they will be overwritten.