Integrate with Webhooks

Learn how to use webhooks to integrate ConvertCalculator with whatever tools or service your company uses.

A very powerful way of integrating calculator submissions with other tools is to use webhooks. The beauty of webhooks is that you don't have to poll data (like how Zapier connects tools). Instead, we send an HTTP request to whatever service you use whenever there is a calculator form submission.

Creating a Webhook

It's super easy to create a new webhook:

  1. In the calculator builder for the calc where you want to create a webhook for, navigate to Settings > Connect > Webhooks.
  2. Toggle on "Sync webhooks on calculator submission"
  3. Enter the URL of the service you want to connect with. This is probably an API endpoint or a lambda function.

Everything is set up correctly. Whenever there is a calculator form submission, an HTTP request will be send to this endpoint.

Event Types

submissions.created

Right now, we only support one event type, namely submissions.created. The submissions.created event occurs every time someone submits a calculator form. This is the object we send to your URL on submission:

JS
{ "type": "submissions.created", "data": { "object": { "_id": "498jcqjmdsYEr9Lsi", "fields": [ { "label": "No", "value": 0, "isHidden": false, "itemId": "fJpszAr4L6HjNzt7X", "name": "Switch Question", "reference": "QA", "collection": "questions", "type": "switch" }, { "label": "50", "value": 50, "isHidden": false, "itemId": "H74QeZmWaGzoqCiob", "name": "Range Question", "reference": "QB", "collection": "questions", "type": "range" }, { "label": "sdfdsf", "value": 1, "data": { "text": "Michael Bluth" }, "isHidden": false, "itemId": "niof4JDqtjK9C2caw", "name": "Name Question", "reference": "QC", "collection": "questions", "type": "textField" }, { "label": "michael@bananastand.com", "value": 1, "data": { "email": "michael@bananastand.com" }, "isHidden": false, "itemId": "CNDghotH8bjuptQK4", "name": "Email Question", "reference": "QD", "collection": "questions", "type": "email" }, { "label": "1,000", "value": 1000, "isHidden": true, "itemId": "euJZie5fQLMGChriQ", "name": "Total Price", "reference": "FA", "collection": "formulas", "type": "formula", "data": { "result": 1000, "resultFormatted": "1,000", "resultFormattedFull": "1,000" } } ], "isProduction": true, "submissionNumber": 2, "createdAt": "2022-03-21T13:26:30.463Z" } } }
ConvertCalculator Icon