Webhook API

webhooks are a way for web applications to get real time notifications when events occur catenda apis support webhooks to allow you to subscribe to events that occur in the catenda platform they are particularly useful for asynchronous events like when a new topic is created or updated when creating any webhooks you will need to provide a url where the webhook events will be sent this url must be publicly accessible and respond with a 200 ok status code to the webhook events examples of platforms that can be used to receive and handle webhook events are zapier and requestbin creating a webhook to create a webhook use the create webhook endpoint with the following parameters name type description event string the event to subscribe to target url string the url to be called when the event occurs anytime the event occurs the target url will be called with the event data supported events are issue created a topic is created issue deleted a topic is deleted issue modified a topic is updated issue status changed the status of a topic is updated library document revision published a document revision is created model created a model is created revision created a model revision is created receiving a webhook event when an event occurs catenda will send a post request to the target url with the event and any project data related to the event name type description event object the event that ocurred project object the project the event occurred in issue object the topic involved in the event libraryitem object the document library item involved in the event if applicable model object the model involved in the event modification object the modification involved in the event, applies to issue modified events revision object the revision involved in the event created by object the user that created the event event the event that occurred name type description id string the id of the event type string the type of the event timestamp string the timestamp of the event modification the modification involved in the event, applies to issue modified events supported modification event types are assigned to removed assigned to updated comment created description updated due date updated due date removed labels added labels removed priority updated status updated title updated type updated viewpoint created name type description event string the modification event that occurred modifiedby object the user involved in the modification event type string the modification event type value string the new value