Get response with the SurveyMonkey API
Returns one response with all answers, its status, times, collector and the respondent data the collector keeps.
- Identifier
- surveymonkey_get_response
The request
POST https://connect.reportei.com/api/tools/surveymonkey_get_response/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"survey_id": "<survey_id>",
"response_id": "<response_id>"
}
}Your system sends your customer's connection id and the tool arguments. The headers are the same as the rest of the Connect API: your product's token and your customer's token.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| survey_id | string | Yes | Id of the survey, from List surveys. |
| response_id | string | Yes | Id of the response, from List responses. |
| simple | boolean | No | true adds the question and answer texts next to the ids. |
| page_ids | string | No | Only the answers of these pages: page ids from Get survey, separated by commas. |
| question_ids | string | No | Only the answers of these questions: question ids from Get survey, separated by commas. |
Supported connections
Your customer connects their SurveyMonkey account once, with one of the modes below. The same connection serves every tool of the toolkit.
OAuth with your product's app
You register your product's OAuth app once, with POST /api/merchants/credentials/surveymonkey, and your customer authorizes the account on a consent screen. Connect renews the token when it is about to expire.
The response
On success, Connect preserves the app's response status and body. HTTP errors returned by the app use the {error, api_error} envelope; authentication or validation can fail before execution. The X-Toolkit-Execution-Id header identifies the recorded execution, available at GET /api/tools/executions/{uuid}.
Ready for AI agents
This tool's input is a JSON Schema, available at GET /api/tools/surveymonkey_get_response. It becomes your agent's tool definition with no conversion.
Other SurveyMonkey tools
- List surveysGETLists the surveys the account owns or that were shared with it, with id, title and nickname; include adds counts, dates and links. Paginate with page while the response has links.next.
- List survey foldersGETLists the survey folders of the account with id, title and number of surveys. Paginate with page while the response has links.next.
- Get surveyGETReturns the whole survey: settings, the edit, preview, collect and analyze links, and every page with its questions and answer choices, all with their ids. The response tools and List survey rollups refer to these ids.
- Create surveyPOSTCreates a survey: empty, copied from another survey with from_survey_id, or with its pages and questions in pages. Returns the survey id and its edit, preview and collect links. It still needs a collector to receive responses.
- Update surveyPATCHChanges the title, nickname, language, button texts, custom variables, footer or folder of a survey. Pages and questions stay as they are.
- List collectorsGETLists the collectors of a survey, the ways it receives responses, like a web link or an email invitation, with id and name; include adds type, status, url and response_count. Paginate with page while the response has links.next.
- Create collectorPOSTCreates a collector for a survey. A weblink collector returns the link to share in url, and it is the only type the free plan can create. An email collector only sets the invitation up: recipients and sending stay in SurveyMonkey.
- Update collectorPATCHChanges a collector: closes it or opens it again with status, or changes its name, close date, response limit, messages and redirect.
Toolkits in the same category
See all 100 toolkitsSee Connect applied to your product.
Try it for 15 days with no card, or walk our team through your use case.
