HTTP POST notifications

A HTTP POST notification is a HTTP message sent from our server, every time a user fills out a survey response, where the payload are HTTP POST variables to a URL that you specify. This is just another method that will help you keep track the progress of your survey.

It also opens possibilities to tie into your own system. If you were for example to use custom tags to help identify the respondent with one of your users, you can update your system automatically with the notification.

To enable HTTP POST notifications for you survey, go to the overview report of that survey. In there, you will see an option to subscribe to HTTP POST notifications.

To subscribe to HTTP POST notifications, just check the checkbox. You will then need to enter the URL into the text field and click the ‘Save’ button.

To change this URL, simply click on the ‘Change’ button and enter another URL, then click on the ‘Save’ button.

To unsubscribe, just uncheck the HTTP Post checkbox.

POST Variables

response_id: The id of the response, this is visible in the survey reports/exports, TEXT value.
survey_id: The id of the survey, TEXT value.
survey_title: The title of the survey, TEXT value.
total_responses: The total number of survey completed responses to date, TEXT value.
start_date: The date and time of when the respondent started the survey, TEXT value.
end_date: The date and time of when the respondent finished the survey, TEXT value.
ip_address: The IP address of the respondent, TEXT value.
country: The country name of the respondent, TEXT value.
custom_tags: An array of the custom tags (if used) appended to the survey URL, ARRAY.
answers_xml: An XML field describing the respondents answers to all the survey questions, XML value.

Example

The following is a typical HTTP POST that you will receive at the URL you specified, each time a respondent fills out a survey.

Array (
   [variables] => Array (
           [response_id] => 123456
           [survey_id] => 100001
           [survey_title] => Cool survey with all question types
           [total_responses] => 23
           [start_date] => 2010-02-15 16:27:00
           [end_date] => 2010-02-15 17:33:17
           [ip_address] => 98.16.84.122
           [country] => Ireland
           [custom_tags] => Array (
                   [0] => Array (
                           [name] => customer_reference
                           [value] => RT123456
           ) )
           [answers_xml] =>
<answers>
	<question number="1">
		<title>Text Single question type</title>
		<answer>Some test single text</answer>
	</question>
	<question number="2">
		<title>Text Paragraph question type</title>
		<answer>Some test paragraph text</answer>
	</question>
	<question number="3">
		<title>Email question type</title>
		<answer>no-reply@gmail.com</answer>
	</question>
	<question number="4">
		<title>URL question type</title>
		<answer>http://google.com</answer>
	</question>
	<question number="5">
		<title>Name question type</title>
		<answer>Tom Thumb</answer>
	</question>
	<question number="6">
		<title>Address question type</title>
		<answer>123 Main Street, Big Town, CA, USA</answer>
	</question>
	<question number="7">
		<title>Date question type</title>
		<answer>10/18/1979 19:16 (mm/dd/yyyy hh:ss)</answer>
	</question>
	<question number="8">
		<title>Matrix multiple question type</title>
		<answer>Question 1:Column 1, Question 2:Column 2, Question 3:Column 3, Question 4:Column 2, Question 5:Column 1, Question 6:Column 2, Question 7:Column 3, Question 8:Column 2, Question 9:Column 1, </answer>
	</question>
	<question number="9">
		<title>Matrix single question type</title>
		<answer>Question 1:Column 6, Question 2:Column 4, Question 3:Column 8, </answer>
	</question>
	<question number="10">
		<title>Multiple choice with other question type</title>
		<answer>Option 1, Option 2, Option 3, Other: test other text</answer>
	</question>
	<question number="11">
		<title>Multiple choice question type</title>
		<answer>Option 1, Option 2, Option 3, </answer>
	</question>
	<question number="12">
		<title>Multiple choice - single/other question type</title>
		<answer>Other: test single other text</answer>
	</question>
	<question number="13">
		<title>Multiple choice - single question type</title>
		<answer>Option 3</answer>
	</question>
</answers>
) )