How to use IBM App Connect with SurveyMonkey

SurveyMonkey is an online survey platform that allows you to create surveys, share them in different ways, and set up lists of recipients.

Availability:
  • A connector in IBM App Connect Enterprise as a ServiceApp Connect Enterprise as a Service connector
  • A local connector in a Designer instance of IBM App Connect in containers (Continuous Delivery release)Local connector in containers (Continuous Delivery release) 11.0.0.10-r1 or later
  • A local connector in a Designer instance of IBM App Connect in containers (Long Term Support)Local connector in containers (Long Term Support release)
  • A local connector in a Designer instance of IBM App Connect in containers (Support Cycle 2)Local connector in containers (Long Term Support Cycle-2 release)
The following information describes how to use IBM® App Connect to connect SurveyMonkey to your other applications.

Supported product and API versions

To find out which product and API versions this connector supports, see Detailed System Requirements on the IBM Support page.

Connecting to SurveyMonkey

Complete the connection fields that you see in the App Connect Designer Connect > Applications and APIs page or flow editor. If necessary, work with your SurveyMonkey administrator to obtain these values.

SurveyMonkey connection fields:
Authorization method Connection field Description Applicability
BASIC OAUTH Access token Create an application in the SurveyMonkey developer console to generate an access token. You will find the access token in your app settings.
Tip: To generate an Access token, see Authentication on the SurveyMonkey Developer page.
Note: SurveyMonkey access tokens do not currently expire but may in the future. For more information, see Token expiration and revocation on the SurveyMonkey Developer page.
App Connect Enterprise as a Service and App Connect in containers

To connect to a SurveyMonkey endpoint from the App Connect Designer Applications and APIs page for the first time, expand SurveyMonkey, then click Connect.

Tip:

Before you use the account that is created in App Connect in a flow, rename the account to something meaningful that helps you to identify it. To rename the account on the Applications and APIs page, select the account, open its options menu (⋮), then click Rename Account.

General considerations

Before you use App Connect Designer with SurveyMonkey, take note of the following considerations:

  • (General consideration) You can see lists of the trigger events and actions that are available on the Applications and APIs page of the App Connect Designer.

    For some applications, the events and actions depend on the environment and whether the connector supports configurable events and dynamic discovery of actions. If the application supports configurable events, you see a Show more configurable events link under the events list. If the application supports dynamic discovery of actions, you see a Show more link under the actions list.

  • (General consideration) If you are using multiple accounts for an application, the set of fields that is displayed when you select an action for that application can vary for different accounts. In the flow editor, some applications always provide a curated set of static fields for an action. Other applications use dynamic discovery to retrieve the set of fields that are configured on the instance that you are connected to. For example, if you have two accounts for two instances of an application, the first account might use settings that are ready for immediate use. However, the second account might be configured with extra custom fields.
  • If you want to add the 'Create collector' action to your flow, you must have an existing survey in SurveyMonkey so that App Connect can create a collector for it; you'll need to specify the name of the survey in App Connect.
  • If you want to add the 'Create contact' action to your flow, you must have an existing contact list in SurveyMonkey for App Connect to add the contact to; you'll need to specify the name of the contact list in App Connect.
  • If you want to add the 'Create recipient' action to your flow, you must have an existing survey and collector in SurveyMonkey so that App Connect can use the collector to send the survey to the new recipient; you'll need to specify the names of the survey and collector in App Connect.

Events and actions

SurveyMonkey events

These events are for changes in this application that trigger a flow to start completing the actions in the flow.

New response

SurveyMonkey actions

Your flow completes these actions on this application.

Collectors
Create collector
Retrieve collectors
Update collector
Delete collector
Contact lists
Create contact list
Retrieve contact lists
Update contact list
Delete contact list
Contacts
Create contact
Retrieve contacts
Update contact
Delete contact
Errors
Retrieve errors
Messages
Create message
Retrieve messages
Update message
Delete message
Pages
Retrieve pages
Questions
Retrieve questions
Recipients
Create recipient
Retrieve recipients
Delete recipient
Responses
Retrieve responses
Surveys
Retrieve surveys

Examples

Dashboard tile for a template that uses SurveyMonkey
Dashboard tile for a template that uses SurveyMonkey
Dashboard tile for a template that uses SurveyMonkey

Use templates to quickly create flows for SurveyMonkey

Learn how to use App Connect templates to quickly create flows that complete actions on SurveyMonkey. For example, open the Templates gallery, and then search for SurveyMonkey.