Skip to main content

At a glance

  • Availability: Experimental (how to enable).
  • Authentication: API key.
  • Connection: The key from SURVEYMONKEY_ACCESS_TOKEN is sent as the Bearer prefixed Authorization header.
  • Provider documentation: Authentication reference.

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.

Provider notes

  • 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.

Tools

Verify the connection

Call a read tool such as surveymonkey__list_surveys with arguments for your account. Confirm that the result comes from the intended account or workspace before enabling write tools.