This article is part of the Insightly Automation Guide
Webhooks are a method of sending information from Insightly to an application outside of Insightly. They can be sent through workflow automation actions when a record is added or updated.
In more technical terms: A webhook is a mechanism for sending notifications using HTTP POST callbacks. For instance, you can set up a workflow to watch for new contacts in a certain region. When a new contact meets your criteria, Insightly will send the contact's information in the webhook to a URI that you've specified.
Insightly's webhooks use Basic authentication, so you can pass through base64-encoded usernames and passwords.
Adding a webhook to a workflow
When you set up a workflow, webhooks are one of the actions you can choose from when a workflow is triggered.
When you select Add New Webhook as an action, you will enter a name describing the webhook and the URI that you would like Insightly to POST information to every time the workflow event happens.
The POST will contain a collection of Field IDs from the record paired with the values of each field. Here is an example for a task:
"TITLE": "New Lead Task",
"STATUS": "NOT STARTED",
Other record types and fields are available in our API documentation.
You can set up a callback URL in your application or integration that will accept the HTTP POST and process the data Insightly sends over, or you can use a service like Zapier, which will accept webhooks and take additional actions in other systems that it's connected to.
If there is no positive acknowledgement when Insightly sends out the webhook, the system will try two more times and then stop attempting to send.