SurveyMonkey

​

What’s supported

​

Supported actions

This connector supports:

• Read Actions, including full historic backfill.
• Write Actions (create, update, and delete — depending on the object).
• Proxy Actions, using the base URL https://api.surveymonkey.com.
• Subscribe Actions are not currently supported.

​

Supported objects

​

Notes and limitations

• Write support
  • contacts, contact_lists, surveys: create, update, and delete
  • survey_folders: create only
  • contact_fields: update only (label)
• Not available as objects: survey responses, collectors, survey pages, survey questions, and webhooks. Use Proxy Actions if you need access to other SurveyMonkey API endpoints.

​

Example integration

For an example manifest file of a SurveyMonkey integration, visit our samples repo on Github.

​

Before you get started

To connect SurveyMonkey with Ampersand, you need to create a SurveyMonkey account and obtain the following credentials from your SurveyMonkey app:

• Client ID
• Client Secret

You will use these credentials to connect your application to Ampersand.

​

Create a SurveyMonkey account

You need a SurveyMonkey account to connect with Ampersand. If you do not have a SurveyMonkey account, here’s how you can sign up:

• Go to the SurveyMonkey site.
• Sign up for a free account using your preferred method.

​

Creating a SurveyMonkey app

1. Log in to the SurveyMonkey Developer Portal.
2. Click the Create a New App button.
3. On the Create a New App form, enter the following details:
   1. App Name: The name of the app.
   2. App Creator: Email address of the app owner.
   3. Select an app type: Specify whether the application should be private or public.
4. Click Create App.
   
5. Click Settings on your app details.
6. In the Redirect URL section, click Add Additional Redirect URL and enter the Ampersand redirect URL: https://api.withampersand.com/callbacks/v1/oauth.
7. Click Submit changes.
8. From the Scopes section, select the scopes required for your application. Common scopes include:
   • View Surveys / Create/Modify Surveys — for reading and writing surveys
   • View Contacts / Create/Modify Contacts — for reading and writing contacts and contact lists
9. Click Update Scopes.
   

You can find the Client ID and Client Secret keys on the Overview page of your application. Note these keys, as they are essential for connecting your app to Ampersand. Some scopes require a paid SurveyMonkey plan or additional approval for public apps. Configure only the scopes your integration uses.

​

Add your SurveyMonkey app info to Ampersand

1. Log in to your Ampersand Dashboard.
2. Select the project where you want to add the SurveyMonkey app.
3. Navigate to the Provider Apps section.
4. Select SurveyMonkey from the Provider list.
5. Enter the previously obtained Client ID in the Client ID field and the Client Secret in the Client Secret field.
6. Click Save Changes.

​

Using the connector

To start integrating with SurveyMonkey:

• Create a manifest file like the example.
• Deploy it using the amp CLI.
• If using Read or Write actions: create a destination.
• Embed the InstallIntegration UI component. The UI component will prompt the customer for OAuth authorization.
• Start using the connector!
  • If your integration has Read Actions, you’ll start getting webhook messages.
  • If your integration has Write Actions, you can start making API calls to our Write API.
  • If your integration has Proxy Actions, you can start making Proxy API calls.

​

API documentation

• SurveyMonkey API v3