> Markdown versions of all pages of this connector library are available by appending `.md` to the page URL. For the full index of connectors, see [llms.txt](https://connectors.appmixer.com/llms.txt).

# Create Collector

- Component: `appmixer.surveymonkey.core.CreateCollector`
- Kind: Action
- Version: 1.0.0
- Visibility: Public
- Connector: [appmixer.surveymonkey 1.0.0](https://connectors.appmixer.com/connector/appmixer.surveymonkey/1.0.0.md)
- Component page: <https://connectors.appmixer.com/connector/appmixer.surveymonkey/1.0.0/component/appmixer.surveymonkey.core.CreateCollector>

Create a collector for a survey: a web link, an email invitation or an SMS collector. A web link collector returns the URL to share with respondents.

## Input ports

### Port `in`

| Field | Type | Description |
| --- | --- | --- |
| Survey (`surveyId`) | text | The survey to collect responses for. Pick a survey, or type its Survey ID. |
| Collector Type (`type`) | select | How the survey is distributed. |
| Name (`name`) | text | The collector name. |
| Thank You Message (`thankYouMessage`) | textarea | The message shown after a respondent completes the survey. |
| Redirect URL (`redirectUrl`) | text | Redirect respondents to this URL when they complete the survey. |
| Close Date (`closeDate`) | date-time | The collector stops accepting responses at this date and time. |
| Response Limit (`responseLimit`) | number | Close the collector after this many responses. |
| Allow Multiple Responses (`allowMultipleResponses`) | toggle | Allow respondents to take the survey more than once from the same browser. Not available for email collectors. |
| Anonymous Responses (`anonymousType`) | select | Turns off IP tracking. For email collectors, also removes the respondent's email address and name from the response. |

## Output ports

### Port `out`

| Field | Type | Description |
| --- | --- | --- |
| Collector ID (`id`) | string | - |
| Survey ID (`survey_id`) | string | - |
| Type (`type`) | string | - |
| Name (`name`) | string | - |
| Status (`status`) | string | - |
| Survey URL (`url`) | string | - |
| Thank You Message (`thank_you_message`) | string | - |
| Disqualification Message (`disqualification_message`) | string | - |
| Disqualification URL (`disqualification_url`) | string | - |
| Close Date (`close_date`) | string | - |
| Closed Page Message (`closed_page_message`) | string | - |
| Redirect URL (`redirect_url`) | string | - |
| Redirect Type (`redirect_type`) | string | - |
| Display Survey Results (`display_survey_results`) | boolean | - |
| Edit Response Type (`edit_response_type`) | string | - |
| Anonymous Type (`anonymous_type`) | string | - |
| Allow Multiple Responses (`allow_multiple_responses`) | boolean | - |
| Password Enabled (`password_enabled`) | boolean | - |
| Sender Email (`sender_email`) | string | - |
| Response Limit (`response_limit`) | integer | - |
| Date Created (`date_created`) | string | - |
| Date Modified (`date_modified`) | string | - |
| API URL (`href`) | string | - |

## Full metadata (component.json)

```json
{
  "name": "appmixer.surveymonkey.core.CreateCollector",
  "label": "Create Collector",
  "description": "Create a collector for a survey: a web link, an email invitation or an SMS collector. A web link collector returns the URL to share with respondents.",
  "author": "Appmixer <info@appmixer.com>",
  "version": "1.0.0",
  "auth": {
    "service": "appmixer:surveymonkey"
  },
  "quota": {
    "manager": "appmixer:surveymonkey",
    "resources": "requests",
    "scope": {
      "userId": "{{userId}}"
    }
  },
  "inPorts": [
    {
      "name": "in",
      "schema": {
        "type": "object",
        "properties": {
          "surveyId": {
            "type": "string"
          },
          "type": {
            "type": "string",
            "enum": [
              "weblink",
              "email",
              "sms"
            ]
          },
          "name": {
            "type": "string"
          },
          "thankYouMessage": {
            "type": "string"
          },
          "redirectUrl": {
            "type": "string"
          },
          "closeDate": {
            "type": "string",
            "format": "date-time"
          },
          "responseLimit": {
            "type": "integer"
          },
          "allowMultipleResponses": {
            "type": "boolean"
          },
          "anonymousType": {
            "type": "string",
            "enum": [
              "not_anonymous",
              "partially_anonymous",
              "fully_anonymous"
            ]
          }
        },
        "required": [
          "surveyId",
          "type"
        ]
      },
      "inspector": {
        "inputs": {
          "surveyId": {
            "type": "text",
            "index": 1,
            "label": "Survey",
            "tooltip": "The survey to collect responses for. Pick a survey, or type its Survey ID.",
            "source": {
              "url": "/component/appmixer/surveymonkey/core/ListSurveys?outPort=out",
              "data": {
                "properties": {
                  "isSource": true
                },
                "transform": "./ListSurveys#toSelectArray"
              }
            }
          },
          "type": {
            "type": "select",
            "index": 2,
            "label": "Collector Type",
            "defaultValue": "weblink",
            "tooltip": "How the survey is distributed.",
            "options": [
              {
                "label": "Web Link",
                "value": "weblink"
              },
              {
                "label": "Email Invitation",
                "value": "email"
              },
              {
                "label": "SMS",
                "value": "sms"
              }
            ]
          },
          "name": {
            "type": "text",
            "index": 3,
            "label": "Name",
            "tooltip": "The collector name."
          },
          "thankYouMessage": {
            "type": "textarea",
            "index": 4,
            "label": "Thank You Message",
            "tooltip": "The message shown after a respondent completes the survey."
          },
          "redirectUrl": {
            "type": "text",
            "index": 5,
            "label": "Redirect URL",
            "tooltip": "Redirect respondents to this URL when they complete the survey."
          },
          "closeDate": {
            "type": "date-time",
            "index": 6,
            "label": "Close Date",
            "tooltip": "The collector stops accepting responses at this date and time."
          },
          "responseLimit": {
            "type": "number",
            "index": 7,
            "label": "Response Limit",
            "tooltip": "Close the collector after this many responses."
          },
          "allowMultipleResponses": {
            "type": "toggle",
            "index": 8,
            "label": "Allow Multiple Responses",
            "defaultValue": false,
            "tooltip": "Allow respondents to take the survey more than once from the same browser. Not available for email collectors."
          },
          "anonymousType": {
            "type": "select",
            "index": 9,
            "label": "Anonymous Responses",
            "tooltip": "Turns off IP tracking. For email collectors, also removes the respondent's email address and name from the response.",
            "options": [
              {
                "label": "Not anonymous",
                "value": "not_anonymous"
              },
              {
                "label": "Partially anonymous",
                "value": "partially_anonymous"
              },
              {
                "label": "Fully anonymous",
                "value": "fully_anonymous"
              }
            ]
          }
        }
      }
    }
  ],
  "outPorts": [
    {
      "name": "out",
      "schema": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "title": "Collector ID",
            "example": "431234567"
          },
          "survey_id": {
            "type": "string",
            "title": "Survey ID",
            "example": "405123456"
          },
          "type": {
            "type": "string",
            "title": "Type",
            "example": "weblink"
          },
          "name": {
            "type": "string",
            "title": "Name",
            "example": "Web Link 1"
          },
          "status": {
            "type": "string",
            "title": "Status",
            "example": "open"
          },
          "url": {
            "type": "string",
            "title": "Survey URL",
            "example": "https://www.surveymonkey.com/r/2Q3RXZB"
          },
          "thank_you_message": {
            "type": "string",
            "title": "Thank You Message",
            "example": "Thank you for taking my survey."
          },
          "disqualification_message": {
            "type": "string",
            "title": "Disqualification Message",
            "example": "Thank you for taking my survey."
          },
          "disqualification_url": {
            "type": "string",
            "title": "Disqualification URL",
            "example": "https://example.com/disqualified"
          },
          "close_date": {
            "type": "string",
            "title": "Close Date",
            "example": "2038-01-01T00:00:00+00:00"
          },
          "closed_page_message": {
            "type": "string",
            "title": "Closed Page Message",
            "example": "This survey is currently closed."
          },
          "redirect_url": {
            "type": "string",
            "title": "Redirect URL",
            "example": "https://example.com/thanks"
          },
          "redirect_type": {
            "type": "string",
            "title": "Redirect Type",
            "example": "url"
          },
          "display_survey_results": {
            "type": "boolean",
            "title": "Display Survey Results",
            "example": false
          },
          "edit_response_type": {
            "type": "string",
            "title": "Edit Response Type",
            "example": "until_complete"
          },
          "anonymous_type": {
            "type": "string",
            "title": "Anonymous Type",
            "example": "not_anonymous"
          },
          "allow_multiple_responses": {
            "type": "boolean",
            "title": "Allow Multiple Responses",
            "example": false
          },
          "password_enabled": {
            "type": "boolean",
            "title": "Password Enabled",
            "example": false
          },
          "sender_email": {
            "type": "string",
            "title": "Sender Email",
            "example": "surveys@example.com"
          },
          "response_limit": {
            "type": "integer",
            "title": "Response Limit",
            "example": 100
          },
          "date_created": {
            "type": "string",
            "title": "Date Created",
            "example": "2026-03-05T14:30:00+00:00"
          },
          "date_modified": {
            "type": "string",
            "title": "Date Modified",
            "example": "2026-03-05T14:30:00+00:00"
          },
          "href": {
            "type": "string",
            "title": "API URL",
            "example": "https://api.surveymonkey.com/v3/collectors/431234567"
          }
        }
      }
    }
  ],
  "icon": "(data URI omitted)"
}
```
