> ## Documentation Index
> Fetch the complete documentation index at: https://veryfront.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# SurveyMonkey

> Access SurveyMonkey surveys, collectors, and response data for analysis and reporting

## At a glance

* **Availability**: Experimental ([how to enable](/cloud/integrations)).
* **Auth**: API key.
* **Connection**: The key from `SURVEYMONKEY_ACCESS_TOKEN` is sent as the `Bearer` prefixed `Authorization` header.
* **Docs**: [https://api.surveymonkey.com/v3/docs#authentication](https://api.surveymonkey.com/v3/docs#authentication)

## Credentials

Set these per environment. See [Connect an integration](/cloud/integrations).

| Variable                    | Required | Description                                                                                              |
| --------------------------- | -------- | -------------------------------------------------------------------------------------------------------- |
| `SURVEYMONKEY_ACCESS_TOKEN` | Yes      | SurveyMonkey access token from a private app (My Apps) [Docs](https://developer.surveymonkey.com/apps/). |

## Setup

1. **Create a SurveyMonkey account**: Sign up at [https://www.surveymonkey.com](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/](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](https://api.surveymonkey.com/v3/docs)

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