> ## Documentation Index > Fetch the complete documentation index at: https://docs.atako.ai/llms.txt > Use this file to discover all available pages before exploring further. # SurveyMonkey > Connect SurveyMonkey to your Atako agents — 11 read and 4 write actions. Let your agents create SurveyMonkey surveys and questions, open web-link collectors, read responses and results, and manage contacts. ## Connection * **Authentication**: OAuth 2.0 (you authorize Atako via SurveyMonkey's consent screen; no key to copy) — or a Private app access token you paste in directly, if you prefer not to use OAuth. * **Required settings** (personal API token option only): * **API host** — api.surveymonkey.com (US), api.eu.surveymonkey.com (EU data center) or api.surveymonkey.ca (Canada). developer.surveymonkey.com → My Apps → Create app. Private app (your own account only): open the app → Settings and copy the Access token, then paste it here; its rights follow your SurveyMonkey plan. In the Host field, keep "api.surveymonkey.com" (US), or enter "api.eu.surveymonkey.com" (EU data center) or "api.surveymonkey.ca" (Canada). Public app (OAuth): set the OAuth Redirect URL to your platform callback URL, copy the Client ID and Secret so your platform admin sets INTEGRATION\_OAUTH\_SURVEYMONKEY\_CLIENT\_ID and INTEGRATION\_OAUTH\_SURVEYMONKEY\_CLIENT\_SECRET, and tick the scopes matching the actions you grant: users\_read, surveys\_read, surveys\_write, collectors\_read, collectors\_write, responses\_read, responses\_read\_detail, contacts\_read, contacts\_write. SurveyMonkey tokens do not expire and have no refresh token: if access is revoked, reconnect. See [SurveyMonkey's documentation](https://developer.surveymonkey.com/apps/). ## Read actions (11) | Action | Description | | ---------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `get_me` | Get the connected SurveyMonkey user (id, username, account type, language, scopes). | | `get_response_details` | Get one full response with all its answers (simple=true, the default here, adds question and answer text). | | `get_survey` | Get a survey (title, counts, dates, analyze/edit/collect/preview URLs). | | `get_survey_details` | Get the full survey design: every page and question with their ids and answer option ids. | | `get_survey_rollups` | Get aggregated results (answer counts per question) for a whole survey, optionally filtered by collector\_ids, creation dates or status. | | `list_collectors` | List the collectors of a survey; `include` adds fields such as type,status,response\_count,url. | | `list_contact_lists` | List contact lists. | | `list_contacts` | List contacts (status active by default); search with search\_by (email, first\_name, last\_name, phone\_number) + search. | | `list_pages` | List the pages of a survey (ids needed by add\_question). | | `list_responses` | List full responses to a survey with every answer (simple=true, the default here, adds question and answer text to the ids). Filter by creation dates, status or collector\_ids (comma-separated); max 100 per page. | | `list_surveys` | List surveys owned by or shared with the user. Filter by title or folder, sort by title/date\_modified/num\_responses; `include` adds fields such as response\_count,date\_modified,preview. | ## Write actions (4) | Action | Description | | ------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `add_question` | Add a question to a survey page: headings \[\{ heading }], family + subtype, answers \{ choices: \[\{ text }] } (rows + choices for matrix; none for open\_ended single/essay), optional position and required \{ text }. | | `create_collector` | Create a collector for a survey. A weblink collector returns the shareable survey `url` in its response. An email collector is created empty (sending invitations is not available here). | | `create_contact` | Create a contact (email and/or phone\_number, first and last name). | | `create_survey` | Create a survey. Either blank (title, optionally pages with questions inline: pages: \[\{ title, questions: \[\{ headings: \[\{ heading }], family, subtype, answers: \{ choices: \[\{ text }] } }] }]) or copied from from\_template\_id / from\_survey\_id. Families: single\_choice (vertical\|horiz\|menu), multiple\_choice (vertical), open\_ended (single\|multi\|essay\|numerical), matrix (single\|rating\|ranking\|menu\|multi, answers.rows + answers.choices). | ## Permissions Every action above must be explicitly granted to an agent before it can be used. See [Permissions](/integrations/permissions) for the grant model and [Security](/integrations/security) for how credentials are protected. *** *Last reviewed against the provider API: September 2026.*