Webhooks let Tormano send events to a system there is no built-in connection for. This is a developer feature: you will need somewhere to receive the request.
Setting one up
There are two ways:
- A standing subscription. Under Settings > Integrations > Webhooks, add the address to send to and select which events it should receive.
- As a workflow action. A workflow can include a Trigger webhook action that posts to an address you give it when the workflow runs.
Each delivery is JSON. Select the events you want per address, from contact.created, contact.updated, contact.deleted, company.created, deal.created, deal.stage_changed, deal.won, deal.lost, donation.created, donation.updated, grant.created, grant.awarded, and activity.created. The full current list is shown on the Webhooks page itself.
Authentication
Every delivery is signed with HMAC-SHA256 in the X-Tormano-Signature header. Verify it on your side with the signing secret shown when you add the address.
Retry behavior
If your system returns an error or does not answer, Tormano retries up to three times, waiting longer between each attempt. Recent deliveries and their responses are listed under each address on the Webhooks page.
Sending data into Tormano
To push data the other way, into Tormano, use the REST API with an API key. See Use the REST API.