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 of 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, hover over the title of your survey in your dashboard and click on View Results:

dashboard-survey-results

Then, click on Analysis:

Analysis

At the bottom of the Analysis screen, you’ll see a section for 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 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.
  • score: Percentage score, if a quiz
  • correct: Number of correct answers, if a quiz
  • start_date_ts: Timestamp representing the date and time of when the respondent started the survey, INT value.
  • end_date_ts: Timestamp representing the date and time of when the respondent finished the survey, INT 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>
) )

Developer Resources

A zap is available from Zapier which integrates with the Polldaddy HTTP POST data.

Polldaddy Tweets
%d bloggers like this:
wpcom_wp_footer