Update collector with the SurveyMonkey API
Changes a collector: closes it or opens it again with status, or changes its name, close date, response limit, messages and redirect.
- Identifier
- surveymonkey_update_collector
The request
POST https://connect.reportei.com/api/tools/surveymonkey_update_collector/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"collector_id": "<collector_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 |
|---|---|---|---|
| collector_id | string | Yes | Id of the collector, from List collectors. |
| status | string | No | open accepts responses again, closed stops the collector.Values: open, closed |
| name | string | No | Name of the collector, shown only to the account. |
| thank_you_page | object | No | Custom thank-you page shown after a response. |
| redirect_type | string | No | End of the survey: url goes to redirect_url (or the standard thank-you page when it is empty), close closes the window and loop starts over, only for a weblink with allow_multiple_responses.Values: url, close, loop |
| redirect_url | string | No | URL the respondent goes to after finishing. |
| close_date | string | No | When the collector stops accepting responses, as an ISO 8601 date and time. |
| closed_page_message | string | No | Message shown when the collector is closed. |
| response_limit | integer | No | Closes the collector after this many responses. |
| allow_multiple_responses | boolean | No | Lets the same browser answer more than once. Not for email collectors. |
| anonymous_type | string | No | Turns off IP tracking; in an email collector, fully_anonymous also drops the email and name of the respondent.Values: not_anonymous, partially_anonymous, fully_anonymous |
| edit_response_type | string | No | When a respondent can still change the answers.Values: until_complete, never, always |
| display_survey_results | boolean | No | Shows the current results to the respondent at the end. |
| password | string | No | Password the respondent must type to open the survey. |
| disqualification_message | string | No | Message for a respondent who is disqualified by the survey logic. |
| disqualification_url | string | No | URL a disqualified respondent goes to. |
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_update_collector. 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.
- List responsesGETLists the responses of a survey with all answers, as question, choice and row ids, plus the texts when simple is true. On the free plan only the first 25 responses of each survey come back, and more returns error 1005. Paginate with page while the response has links.next.
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.
