Using the New FluidSurveys API (Part 2)

Last week we showed you how to use the new FluidSurveys API to GET some basic information out of the API.   Today we send some data to the API to create emails.

Tutorial Part II: POST-IT

In part one of our tutorial we showed you how to GET data from the API. This time we show you how to POST data to the API.


In part I our proxy only needed to handle GET requests. Now we need to add a function in proxy.php to handle POST:

function POST($url,$data='',$form=false){

        global $api_key, $password;
                $type = 'Content-Type: application/x-www-form-urlencoded';

                $type = 'Content-Type: application/json';
        $curl = curl_init();

        curl_setopt($curl, CURLOPT_HTTPAUTH, CURLAUTH_BASIC) ;
        curl_setopt($curl, CURLOPT_USERPWD, $api_key.':'.$password);

        curl_setopt($curl, CURLOPT_SSLVERSION,3);
        curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, FALSE);

        curl_setopt($curl, CURLOPT_SSL_VERIFYHOST, 2);
        curl_setopt($curl, CURLOPT_HEADER, false);

        curl_setopt($curl, CURLOPT_POST, true);
        curl_setopt($curl, CURLOPT_POSTFIELDS, $data);

        curl_setopt($curl, CURLOPT_HTTPHEADER, array($type,'Content-Length: ' .

        curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);

        curl_setopt($curl, CURLOPT_USERAGENT, "Mozilla/4.0 (compatible;
                MSIE 5.01; Windows NT 5.0)");
        curl_setopt($curl, CURLOPT_URL, $url);

        $data = curl_exec($curl);

        return $data;

We then need to modify the main body of of proxy.php file so that it handles GET and POST requests:


        if (count($_POST) == 0){

                        //if $_POST is empty there is no form data
                        $form = false;
                        $raw = file_get_contents('php://input');

                //PHP doesn't let us access raw post data if it's part of a form,
                //so we recreate the request body ourselves
                $form = true;

                $raw = '';
                foreach($_POST as $key => $value) {

                        $raw = $raw.$key.'='.$value.'&';

        echo POST($_GET['method'], $raw, $form);

}elseif ($_SERVER['REQUEST_METHOD'] == 'GET'){
        echo GET($_GET['method']);

        echo 'Error: Request must be POST or GET';

POSTing to the API

We need to make a small change to our JavaScript function that calls the API to tell it which data to POST.

function callAPI(type,url,data,callback){

        //our AJAX function that calls our proxy

        var proxy = '';

        var j = $.ajax({

                        beforeSend: function(xhr){
                                if(typeof(data) === 'string' && data.lastIndexOf(

                                        '{', 0) ===0){
                                        xhr.setRequestHeader('Content-Type', 'application/json');}

                                else {xhr.setRequestHeader('Content-Type',

                        url: proxy+url,
                        type: type,
                        data: data,

                        success: function(data){
                                //since the API always returns JSON - we will parse the data
                                //right here and pass it to callback

                        error: function(event, jqXHR, ajaxSettings, thrownError){

                                console.log(event, jqXHR, ajaxSettings, thrownError);


We’ve done a few things here. First, added a data parameter which is what we’re going to be POSTing. Remember to go back and pass a null or empty string for our GET requests. Or if you’re feeling fancy look at through the function’s arguments dynamically. Second, we set the headers based on the type of data. Lastly, we set the jQuery.ajax’s data value to equal our own.

Getting Contacts

In order to send an email we first need some contacts to send it to. You can fetch your contact lists with a GET request:


We will call this from the document ready function the same time we get our list of surveys:


        callAPI('GET','/surveys/',false, function(data){
                //see part I of the tutorial


        //now call request the contact-lists


We get our lists of contacts on document ready and send the result the loadContacts function

function loadContactLists(data){
        //Recieves a list of contact lists and stores them in the global CONTACTLISTS.
        for(var i=0; i<; i++){

                //add each list to CONTACTLISTS
                        contacts: data.lists[i].contacts,

                        contacts_uri: data.lists[i].contacts_uri,
                        id: data.lists[i].id,

                        name: data.lists[i].name,
                        uri: data.lists[i].uri


This simply loops through the contact lists that have been returned and stores them in the global list CONTACTLISTS.

Update Survey Details

We will update the survey details to include a link to our list of contact lists.

markup = "<h3>Created by "+survey.creator+" on "+survey.created_at+"

        </h3><a href="#" id="responses">View "+survey.responses+
                " Responses<a><br /><br /><a href='#' id='displayContactLists'>

                        Send Invites</a><br /><br /><a href=""+survey.deploy+"">
                                Take the Survey</a><br /><br /><a href='./'>&larr;&nbsp;Surveys</a>";

// ...


                        return false;

And the showcontactLists function which will display a simple unordered list of our contact lists:

function showContactLists(){
//renders the contact lists to the page
var lists = $('<ul id="#contactlists" />'), markup = '';

for(var i=0; i<CONTACTLISTS.length; i++){

        markup += '<li><a href="#" id="c_'+CONTACTLISTS[i].id+'">'

                + CONTACTLISTS[i].name + "</a></li>";


        sendEmail(;        //parse the actual ID from the DOM ID



Send the Email

Finally, we get to POST something. In the showContactLists function above we attached a function called sendEmail to fire when a contact list is clicked.
In order to create an email we POST our message data to /emails/?survey=:surveyid. Once the email has been created our POST request will return a` recipients_uri` that we can use to add our contact list. Finally, once that has been done we can use the send_uri returned from creating the email to actually send it.

function sendEmail(contactlist){

        //we are going to send an email to contactlist but first we need to create the
        // email, once this is done we attach our contact list, and once that is done
        // we send the email
        callAPI('POST',base+'/emails/?survey='+SURVEY,'{"message":"Hello Friends!

                [Invite Link]", "sender":"John <>", "subject":
                "Hello World"}', function(email){
                //once the email has been created, we add the contactlist to the email

                callAPI('POST', email.recipients_uri, {'contact_list': contactlist},

                        //once the contactlist has been added to the email,
                        //we are ready to send!
                        callAPI('POST', email.send_uri, '', function(){

                                //once the email has been sent, notify the user
                                //and take them back to the survey details
                                alert('Your email will be sent shortly!');


We build the email by passing in a set of values for the subject, sender, and email. You might want to collect these from inputs that the user has filled in. Be sure to include the string [Invite Link] in the message field or else it won’t work! This is replaced with the URL to the survey when the email gets sent. If all goes well you should see an email in your Reminders/History that is schedules to go out shortly to your contacts on the chosen contact list!

FluidSurveys Presents

Free Survey Q&A

Join our survey & research expert Rick Penwarden as he answers all of your questions every Wednesday at 1PM EST!

Comments are closed here.