Webhooks are automated messages that get sent to some URL when something happens in the app.
Why would you use them?
Webhooks allow your apps to get a notification when something happens in Clockify so your app can take an appropriate action. For example, if a time entry is created in Clockify, webhook will let you know about it so you can send that time entry into your own system.
How are webhooks different from API?
Webhooks are useful when you need to listen for an event. For example, lets say you want to be notified when a new project is created in Clockify. By using API, you’d need to GET all projects every few hours and make custom logic to see what’s new. But with webhooks, your app can get notified when a project is created instantly, without needing to ask the system “hey, anything new?” every few minutes.
About webhooks in Clockify
You can access webhooks from your Profile settings (it’s located below you API key)
Each user can have up to 10 webhooks per workspace, and a workspace can have 100 in total
Only the user who created the webhook can see and modify it
Nice job ! Time entry created webhook is a bit confusing to me. It only works with manually added time entry. It won’t work if I create an entry with the timer.
The zapier webhook works this way, so it added up to my confusion.
Great feature! Nice job!
Would it be possible to add an “event_type” field highlighting the different types of events to allow us to identify more easily when they all point to the same endpoint?
@Matsuura_Taiki Thanks for reporting this, we’ll check the URL validation as soon as possible.
@ybussieres Thanks! Time entry created refers to manually added entries, Timer started and Timer stopped are events for time entries made using the timer.
@jack Yes, we’ll add the “event_type” field, thanks.
@chauser@fca Can you check the log for the created webhook to see if there’s additional info?
Webhooks can be used on the free plan, so you don’t need a subscription to use it.
@jovana My log is blank. When I click “send test” I get a notification saying “Test Sent” but I don’t see a message in my application. I have verified with Postman that my endpoint is working. I have tried using the entry_created and timer_stopped events with no luck.
@jovana Thanks your your quick work! My initial tests seem to be working. I will continue to provide feedback if I have any more issues! @fca Seems to be working hope you have your issues solved!
