Note
The Webhooks feature is available to everyone from version 23.2.3 onwards.
As the feature is currently in the beta phase, we are monitoring it closely and are making sure that all our events are properly triggered. Have you experienced any issues? Please reach out to us at: api[at]xentral.com.
A webhook allows you to receive information about events happening in Xentral in an external system. For example, you could get a notification in your application every time a new sales order is created. The information is sent to your external system via an HTTP POST request.
Tip
To learn more technical information about webhooks and possible events, check out the developer documentation.
Note
Creating webhooks requires administrator privileges.
To create a webhook:
-
Go to
Settings > Integrations > Webhooks. You will see a list of all webhooks in active use.
-
Click on + Create new Webhook. If there are no webhooks active, you will find the button in the middle of the screen. Otherwise you will find it on the top right of your list.
-
Enter a unique Name for your webhook. The name should not exceed 100 characters.
-
Enter the URL endpoint that should receive information from the webhook. Only secure https URLs are allowed. The URL should not exceed 255 characters.
-
Take note of the Signature key. It will be copied to your clipboard, when you finish creating the webhook. This field is automatically filled with a random 20 character string which serves as the signature key. If you prefer, you can overwrite it with your own string that consists of 20 to 255 characters or you can copy it to clipboard yourself by clicking
in the Signature Key field and copying the string.
Important
The signature key enables the receiving system to ensure that the information really is from Xentral . Don't show this key publicly or hardcode it into your system.
-
Select an Event. It is also possible to select multiple events, if needed. The webhook sends out information to the endpoint every time one of these events happen.
-
Click Create. The signature key will be copied to clipboard and appear on screen one last time. Click
if you want to make sure the key has been copied.
-
Close the window.
Your new webhook is displayed in the list of active webhooks. In the overview you can quickly see the URL endpoints and the attached events for every webhook you created.
All webhooks will be listed under Settings > Integrations > Webhooks. When you click
Edit you have two options:
-
Edit settings - You can change the name, URL endpoint and signature key as well as add or remove events from the webhook. If you change the signature key you must also update it in your external application.
-
Delete webhook - Click on Delete webhook below the list of events and confirm the deletion request. The external system won't receive new information about events in Xentral anymore.