First, configure the webhook in the relevant widget (e.g. poll, quiz, survey, etc) creation form:

  1. Edit the widget creation form

  2. Go to the "Integration Settings" section

  3. Set on the "Enable custom webhook" checkbox and configure the URL you want the data to be sent to.

Each time a user completes answering all the questions in the widget and gets a result, Opinion Stage will send the submitted data to the configured URL.

In what format is the data sent?

Opinion Stage sends the data via a POST request to the configured URL. The data is encoded as JSON key-value pair in the body of the request. Keys can be found in the webhook configuration page ("Webhook key"), and corresponding values are the actual data (e.g. answer to card) submitted to that key.


To illustrate how the system sends webhook data, following are some examples:

curl command-line utility:

curl --data '{"key": "value"}' -H 'Content-Type: application/json' --

php cURL:

$url = '';
$ch = curl_init($url);

curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'POST');
curl_setopt($ch, CURLOPT_HTTPHEADER, array('Content-Type: application/json'));
curl_setopt($ch, CURLOPT_POSTFIELDS, '{"example":"payload"}');



Best practices

  1. Use an  HTTPS url for webhooks, so the data is sent encrypted and secure.

  2. Verify the webhook url is always accessible. Note that if data is sent to a URL that doesn't respond, Opinion Stage tries sending a few times before failing.

Did this answer your question?