A webhook is a method to provide external applications with real-time information about data changes in a platform.
A webhook delivers data to the application at the moment that there is a change, resulting in data being pushed. Unlike REST APIs where the application polls the API at regular intervals in order to get the changed data. This makes webhooks much more efficient and friendly.
{"linked_account_id":"12345","org_id":"645270e37917442c4307297a","environment":"test","type":"General","event":"Connection Created","slug":"hubspot","createdAt":"Tue, 07 Nov 2023 08:03:27 GMT"}
A connection is deleted
{"linked_account_id":"12345","org_id":"645270e37917442c4307297a","environment":"test","type":"General","event":"Connection Deleted","slug":"hubspot","createdAt":"Tue, 07 Nov 2023 08:04:27 GMT"}
A connection is removed or does not exist
{"linked_account_id":"12345","org_id":"645270e37917442c4307297a","environment":"test","type":"General","event":"Connection Expired","slug":"pipedrive","createdAt":"Tue, 07 Nov 2023 08:38:33 GMT"}
Workflow has been successfully executed
{"linked_account_id":"12345","instance_id":"656f30f69144bb8f183c0118","workflow_id":"6495792b9b6ca6d77a17e513","config_id":"12345","event":"Workflow Completed","workflow_name":"Export contact to Hubspot","status":"COMPLETED"}
Workflow execution stopped because of an error
{"linked_account_id":"12345","instance_id":"656f308b9144bb8f183bfc7b","workflow_id":"6495792b9b6ca6d77a17e513","config_id":"12345","event":"Workflow Errored","workflow_name":"Export contact to Hubspot","status":"ERRORED"}
To create a Webhook subscription, enter the delivery URL of the webhook endpoint from your system, and select the desired events you want to receive webhook events for.
Webhooks should use HTTPS and expect to receive POST requests
After you pressed “Save”, you are subscribed to the Webhook events.
On receiving an event, you should respond with an HTTP 200 OK to signal to Cobalt that the event was successfully delivered. Otherwise, Cobalt will consider the event delivery a failure and retry up to 3 times, with exponential backoff.