Connectors / Service / Survey Monkey

Survey Monkey

Survey Monkey

Survey Monkey is online survey software that helps you to create and run professional online surveys

Overview

SurveyMonkey is a cloud-based survey tool that helps users create, send and analyze surveys.

API INFO: The Base URL used for the Survey Monkey connector is https://api.surveymonkey.com/v3. More information can be found on their main API documentation (v3.0) site.

Authentication

Within the workflow builder, highlight the Survey Monkey connector.

In the Survey Monkey connector properties panel to the right of the builder, click on the Authenticate tab and the 'Add new authentication' button.

This will result in a Tray.io authentication pop-up modal. The first page will ask you to name your authentication and select the type of authentication you wish to create ('Personal' or 'Organisational').

The next page will alert you that no extra permissions need to be set for this service. Click on the 'Create authentication' button, and you will directed to a separate pop-up where you will enter your Survey Monkey username and password. This is the same username/password you use to sign in to the Survey Monkey website.

Once you have successfully logged into Survey Monkey, go back to your settings authentication field (within the workflow builder properties panel), and select the recently added authentication from the dropdown options now available.

Your connector authentication setup should now be complete.

Available Operations

The examples below show one or two of the available connector operations in use.

Please see the Full Operations Reference at the end of this page for details on all available operations for this connector.

Survey Monkey Trigger

If you wish your workflow to be kicked off by a particular action in Survey Monkey, you can use the Survey Monkey Trigger.

The Survey Monkey trigger allows you to receive notifications and trigger workflows when given events occur associated with the selected trigger operation.

Trigger operations available:

  • New survey response

The first step is to select the New survey response operation for the trigger.

You can now select the survey ID from the drop-down options available within the Survey ID input field and thereby choose the survey you wish to receive responses for. Press Enable to enable the trigger.

Once a survey is completed that corresponds to this ID, your workflow will begin.

Webhook Setup

Before being able to use the Survey Monkey trigger, authentication will need to be created. To do so, add the Survey Monkey trigger to the workflow and hit the New Authentication button found under the input panel:

The next windows provide ask you to name your authentication, as well as display the scopes that will be requested.

Please ensure that the two scopes required for trigger activation are selected:

View Webhooks & Create/Edit Webhooks

Once you have done this, press the Add authentication button.

Using the Raw HTTP Request ('Universal Operation')

As of version 1.0, you can effectively create your own operations.

This is a very powerful feature which you can put to use when there is an endpoint in Survey Monkey which is not used by any of our operations.

To use this you will first of all need to research the endpoint in the Survey Monkey API documentation v3.0, to find the exact format that Survey Monkey will be expecting the endpoint to be passed in.

Note that you will only need to add the suffix to the endpoint, as the base URL will be automatically set (the base URL is picked up from the value you entered when you created your authentication).

The base URL for Survey Monkey is: https://api.surveymonkey.com/v3

For example, say that the 'List contact lists' operation did not exist in our Survey Monkey connector, and you wanted to use this endpoint. You would use the Survey Monkey API docs to find the relevant endpoint - which in this case is a GET request called: /contact_lists.

More details about this endpoint can be found here.

As you can see there is also the option to include a query parameter, should you wish to do so. So if you know what your method, endpoint and details of your query parameters are, you can list all contact lists with the following settings:

Method: GET

Endpoint: /contact_lists

Query Parameter: Key: page Value: 1 Key: per_page Value: 20

Final outcome being: https://api.surveymonkey.com/v3/contact_lists

Example Usage

TRAY POTENTIAL: Tray.io is extremely flexible. By design there is no fixed way of working with it - you can pull whatever data you need from other services and work with it using our core and helper connectors. This demo which follows shows only one possible way of working with Tray.io and the Survey Monkey connector. Once you've finished working through this example please see our Introduction to working with data and jsonpaths page and Data Guide for more details.

Below is an example of a way in which you could potentially use the Survey Monkey connector, to list all of your contact lists and list contacts from each list retrieved.

The steps will be as follows:

  1. Setup using a manual trigger and list contact lists.
  2. Loop through the list of contact lists.
  3. List contacts in each contact list.

Your completed workflow should look similar to this:

1 - Setup Trigger & List Contact Lists

Select the manual trigger from the trigger options available. From the connectors panel on the left, add a Survey Monkey connector to your workflow. Set the operation to 'List contact lists'.

Feel free to re-name your steps as you go along to make things clearer for yourself and other users. The operation names themselves often suffice.

Upon completion of this first step, a list of contact lists from your account will have been retrieved.

2 - Loop Through the List of Contact Lists

Next, search for the Loop collection connector within your connector panel, and drag it into your workflow as your next step. Set your operations to 'Loop list'.

The Loop Collection connector allows you to iterate through a list of results. In this example, we will use it to iterate through the data found within the previous Survey Monkey connector step.

In order to specify the list you want to loop through, start by using the list mapping icon (found next to the list input field, within the properties panel) to generate the connector-snake.

While hovering over the 'List contact lists' step (with the tail end of the connector-snake), select data from the list of output properties displayed. This will auto-populate a jsonpath within your list input field, and update the type selector to jsonpath.

For more clarification on the pathways you have available, open the Debug panel to view your step's Input and Output.

JSONPATHS: For more information on what jsonpaths are and how to use jsonpaths with Tray.io, please see our Intro page and Data Guide for more details.
CONNECTOR-SNAKE: The simplest and easiest way to generate your jsonpaths is to use our feature called the Connector-snake. Please see the main page for more details.

Once this step has been set up, you will be able to loop through the list of contact lists you retrieved in step 1.

3 - List Contacts From Each List

The last step is to drag a Survey Monkey connector inside of the Loop Collection step itself. Set the operation to 'List contacts'. As you can see, the 'contact list ID' field is required. This can be obtained by using the connector snake once again to hover over the 'Loop Collection' step and selecting id from the list of output properties displayed.

INTERPOLATION: When you wish to include JSON generated data within another input/ output/ result, use our Interpolation method as described here.

With this last step completed, you will have successfully retrieved the list of contacts associated to each contact list available in your account.

BEST PRACTICES: Whenever you do decide to create your own workflow, please make sure you take a look at our Managing data best practices guide.

All Operations

Latest version:

1.1