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!
