Skip to main content

At a glance

Credentials

Set these per environment. See Connect an integration.

Setup

  1. Create a SurveyMonkey account: Sign up at https://www.surveymonkey.com and create at least one survey so the API has data to return. A free Basic plan is enough for the survey and collector tools, but retrieving response details via the API requires a paid plan.
  2. Register a developer app: Go to https://developer.surveymonkey.com/apps/, sign in with your SurveyMonkey account, and create a new app. Private apps are tied to your own account and are the simplest option.
  3. Set scopes and copy the access token: In the app’s settings, enable the scopes you need (View Surveys, View Collectors, View Response Details) and deploy the app. Copy the access token shown on the app’s credentials page.
  4. Configure the environment variable: Set SURVEYMONKEY_ACCESS_TOKEN to the access token. It is sent as ‘Authorization: Bearer <token>’ on every request.
  • This connector uses the US data center base URL (api.surveymonkey.com). Accounts in the EU or Canada data centers use api.eu.surveymonkey.com or api.surveymonkey.ca instead.
  • The ‘View Response Details’ scope (responses_read_detail) requires a paid SurveyMonkey plan - on a free Basic plan the List Survey Responses and Get Response Details tools will be denied. Free accounts are also capped at 40 responses per survey overall.
  • Viewing full response answers requires the ‘View Response Details’ scope on your app.
Provider API reference: https://api.surveymonkey.com/v3/docs

Tools

Example prompts

  • Pick one of my SurveyMonkey surveys, pull its latest responses, and summarize the key findings and trends.
  • List my SurveyMonkey surveys with their response counts and last modified dates.
  • Show me the collectors for my most recent survey and how many responses each has gathered.