⚠️ Attention:
You cannot activate this functionality yourself. If you do not see the "Webhooks" section under Admin → Management → Settings, please contact our support via the chat 💬.
ℹ️ What are webhooks?
Admins can now view and manage webhooks to notify third parties when certain events occur in Strobbo, such as:
⏰ Employee clock-in and clock-out
📄 External contracts
Third parties can set up a URL to which we send information about certain events in real time, so they can respond as they wish (for example, updating Dimona on clock-in/out).
⚙️ How to set up webhooks
Go to Management → Settings → Webhooks
Click the green "Add" button at the top right of the table to create a new webhook.
Fill in the following fields in the modal:
📝 Name, description:
Enter a custom name and description for the webhook.
🌐 Webhook URL:
Specify the URL to which the event will be sent when triggered. This must be a valid HTTPS URL, including the protocol (e.g., https://).
👥 User group:
If you select a specific user group, the endpoint will only receive events generated by users in that group.
Leave it blank for the webhook to apply to all user groups.
📊 Event types:
Send me everything: Receive all events.
Let me select individual events: Choose specific categories of events the webhook should trigger on.
⏰ Event group: clocking
This event group includes all events related to employee clocking actions. The specific events in this group are:
Employee clock in
Employee clock out
Employee cancelled clock-in
📄 Event group: External contracts
This event group includes all events related to contract actions. The specific events in this group are:
External contracts ready
🛠️ Custom headers:
By default, this section is collapsed in the form.
Here you can define which request headers should be added to each webhook request.
✏️ Editing a webhook
Clicking the edit button (pencil) opens the same modal used to create a webhook. This allows you to update the details of a webhook after creation.
🕒 Viewing webhook history
Clicking the history button (clock, behind the more actions option, shows an overview of all messages sent to the endpoint.
At the top of the table, you will find a date filter to limit the history.
Click the 🔄 refresh button to update the table with the latest entries in the history.
▶️⏹️ Activating, deactivating, and deleting webhooks
Deactivate: Click the stop symbol (red stop) to temporarily disable a webhook.
Activate: Click the green arrow to enable a webhook again.
Delete: Click the trash icon 🗑️ to permanently delete a webhook.