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.| Variable | Required | Description |
|---|---|---|
SURVEYMONKEY_ACCESS_TOKEN | Yes | SurveyMonkey access token from a private app (My Apps) Docs. |
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
| Tool | Access | Description |
|---|---|---|
| List Surveys | Read | List surveys owned by or shared with the authenticated account |
| Get Survey Details | Read | Get a survey’s full design, including pages, questions, and answer option IDs needed to interpret responses |
| List Survey Responses | Read | List full responses for a survey, including each answer keyed by question and choice IDs |
| Get Response Details | Read | Get a single survey response with all answers expanded |
| Get Survey Rollups | Read | Get aggregated answer counts and statistics per question - summarize results without paging every response |
| List Survey Folders | Read | List the survey folders in the account to find folder IDs for filtering surveys |
| List Collectors | Read | List the collectors (web links, email invitations, etc.) that gather responses for a survey |
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.