Automated processes with webhooks
Clockodo expands integration options with webhooks. This new feature enables direct communication between Clockodo and other applications.
Benefits of webhooks
Webhooks simplify the integration of external applications and automate recurring processes. Companies managing digital workflows efficiently benefit from seamless, real-time connectivity.
- Real-Time Updates: Receive instant notifications for important events.
- Automation: Trigger actions automatically to streamline workflows.
- Efficiency: Reduce the need for constant API polling.
- Scalability: Easily integrate with other systems and services.
Available webhooks in Clockodo
The following webhook types are available:
- User
- Absences
- Customer
- Project
- Subproject
- Service
- Lump sum service
- Team
- Holiday quota
- Holidays carry
- Overtime carry
- Nonbusiness group
- Worktime changes and change requests
For each type, a webhook can be created for the events creation, update and deletion.
How many webhooks can you create?
- Customers with Basic, Pro, and Freelancer plans can create two webhooks.
- Enterprise customers can create three Webhooks per type.
This allows multiple processes to run in parallel automatically.
Setting up a webhook
Create a new webhook under the "Webhooks" tab in the menu. Choose an event from the dropdown list to receive notifications from. Assign a unique token and enter the endpoint URL.
Validating a webhook
Clockodo verifies the specified endpoint before activation. The validation process includes the following steps:
- By clicking on the ‘Validate webhook’ button, Clockodo sends a validation request to the endpoint.
- The endpoint is sent a secret via URL parameter, which you enter in Clockodo.
- The webhook activates after successful verification.
If you later change the server URL, repeat the validation process.
Managing a webhook
After setup, additional functions are available:
- Delete: Remove webhooks that are no longer needed.
- Edit: Modify the event or token without extra steps. Changing the URL requires revalidation.
- Protocol: Check which events have been sent to the endpoint.
What information does the notification contain?
When the event for which you have set up a webhook occurs, you will receive an HTTP message to the stored URL. This contains the ID of the affected resource, the event and the token that you assigned during creation.
The specific change that triggered the event is not transmitted. You can use the transmitted ID to query the current data of the required resource via our API.
With the help of the token, you can be sure that the message actually comes from Clockodo.
