At a glance
- Availability: Experimental (how to enable).
- Auth: API key.
- Connection: The key from
SURVEYMONKEY_ACCESS_TOKENis sent as theBearerprefixedAuthorizationheader. - Docs: https://api.surveymonkey.com/v3/docs#authentication
Credentials
Set these per environment. See Connect an integration.Setup
- 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.
- 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.
- 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.
- 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.
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.