View as Markdown
SurveyMonkey icon

SurveyMonkey ACTION

Create Collector

Create a collector for a survey. A collector is the channel responses come in through — an SMS or email invitation, a web link, or a popup. See the documentation
  • Action
  • Writes data
  • OAuth
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's SurveyMonkey account once, then configure and run Create Collector from your backend or agent.

import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const result = await pd.actions.run({
  id: "survey_monkey-create-collector",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    survey_monkey: { authProvisionId: "apn_xxxxxxx" },
    survey: "Survey",
    type: "Type",
  },
})

console.log(result)

SCHEMA

Inputs

Pipedream supplies the connected account. Your application provides the operation-specific values below. Dynamic inputs are resolved against that user's account.

Create Collector inputs
Property Type Description
survey Survey string
Select a Survey from the list.
Alternatively, you can provide a custom Survey ID.
Required Dynamic
type Type string
The kind of collector to create. Every type except Web link requires a paid SurveyMonkey plan.
Required
name Name string
A nickname for the collector.
Required
senderEmail Sender Email string
Sender email for email collectors. The address must be verified in your SurveyMonkey account before invitations will send.
Optional
thankYouMessage Thank You Message string
Message shown on the thank you page once a respondent completes the survey. SurveyMonkey treats this as the older form of thank_you_page and recommends that object instead — pass it through Additional Options to use it.
Optional
closedPageMessage Closed Page Message string
Message shown once the survey is closed.
Optional
redirectUrl Redirect URL string
Redirect respondents to this URL on survey completion.
Optional
closeDate Close Date string
When the collector should close, e.g. 2026-12-03T10:15:30+00:00.
Optional
responseLimit Response Limit integer
Close the collector after this many responses.
Optional
anonymousType Anonymous Type string
Turns off IP tracking. For email collectors it also removes the respondent's email address and name from the response.
Optional
editResponseType Edit Response Type string
When respondents can edit their response.
Optional
isBrandingEnabled Is Branding Enabled boolean
Whether the popup has SurveyMonkey branding. Only applies to popup collectors.
Optional
additionalOptions Additional Options object
Any other collector option to send in the request body, e.g. {"thank_you_page": {"is_enabled": true, "message": "Thanks!"}} or the popup-only width/height/sample_rate settings. See the documentation for the full list. Note that values typed directly into this field arrive as strings, so pass booleans and numbers from a previous step or an expression when the API expects those types.
Optional

REFERENCE

Tool details

Behavior hints are published with the component in the Pipedream registry and surface as MCP tool annotations, so an agent can reason about a tool before it calls it.

Registry key
survey_monkey-create-collector
Version
0.0.2
App
SurveyMonkey
Authentication
OAuth
Read-only
No
Destructive
No
Open world
Yes