> 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 Survey

- Component: `appmixer.surveymonkey.core.CreateSurvey`
- 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.CreateSurvey>

Create an empty survey, or a copy of an existing survey or of a SurveyMonkey template. Add pages and questions with Make API Call (POST /v3/surveys/{id}/pages).

## Input ports

### Port `in`

| Field | Type | Description |
| --- | --- | --- |
| Title (`title`) | text | The survey title. SurveyMonkey uses "New Survey" when empty. |
| Nickname (`nickname`) | text | An internal nickname of the survey. Ignored when copying a survey or a template. |
| Language (`language`) | text | ISO 639-1 code of the survey language, for example `en` or `de`. Defaults to `en`. Ignored when copying a survey or a template. |
| Folder ID (`folderId`) | text | Adds the survey to the folder with this ID. Ignored when copying a survey or a template. |
| Copy From Survey (`fromSurveyId`) | text | Create a copy of this survey (pages and questions included). Pick a survey, or type its Survey ID. Leave empty to create an empty survey. |
| Copy From Template ID (`fromTemplateId`) | text | Create the survey from this SurveyMonkey template (see GET /v3/survey_templates). Use either Copy From Survey or Copy From Template ID. |

## Output ports

### Port `out`

| Field | Type | Description |
| --- | --- | --- |
| Survey ID (`id`) | string | - |
| Title (`title`) | string | - |
| Nickname (`nickname`) | string | - |
| Language (`language`) | string | - |
| Category (`category`) | string | - |
| Question Count (`question_count`) | integer | - |
| Page Count (`page_count`) | integer | - |
| Response Count (`response_count`) | integer | - |
| Date Created (`date_created`) | string | - |
| Date Modified (`date_modified`) | string | - |
| Folder ID (`folder_id`) | string | - |
| Footer (`footer`) | boolean | - |
| Custom Variables (`custom_variables`) | object | - |
| Buttons Text (`buttons_text`) | object | - |
| Preview URL (`preview`) | string | - |
| Edit URL (`edit_url`) | string | - |
| Collect URL (`collect_url`) | string | - |
| Analyze URL (`analyze_url`) | string | - |
| Summary URL (`summary_url`) | string | - |
| API URL (`href`) | string | - |

## Full metadata (component.json)

```json
{
  "name": "appmixer.surveymonkey.core.CreateSurvey",
  "label": "Create Survey",
  "description": "Create an empty survey, or a copy of an existing survey or of a SurveyMonkey template. Add pages and questions with Make API Call (POST /v3/surveys/{id}/pages).",
  "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": {
          "title": {
            "type": "string"
          },
          "nickname": {
            "type": "string"
          },
          "language": {
            "type": "string"
          },
          "folderId": {
            "type": "string"
          },
          "fromSurveyId": {
            "type": "string"
          },
          "fromTemplateId": {
            "type": "string"
          }
        }
      },
      "inspector": {
        "inputs": {
          "title": {
            "type": "text",
            "index": 1,
            "label": "Title",
            "tooltip": "The survey title. SurveyMonkey uses \"New Survey\" when empty."
          },
          "nickname": {
            "type": "text",
            "index": 2,
            "label": "Nickname",
            "tooltip": "An internal nickname of the survey. Ignored when copying a survey or a template."
          },
          "language": {
            "type": "text",
            "index": 3,
            "label": "Language",
            "tooltip": "ISO 639-1 code of the survey language, for example <code>en</code> or <code>de</code>. Defaults to <code>en</code>. Ignored when copying a survey or a template."
          },
          "folderId": {
            "type": "text",
            "index": 4,
            "label": "Folder ID",
            "tooltip": "Adds the survey to the folder with this ID. Ignored when copying a survey or a template."
          },
          "fromSurveyId": {
            "type": "text",
            "index": 5,
            "label": "Copy From Survey",
            "tooltip": "Create a copy of this survey (pages and questions included). Pick a survey, or type its Survey ID. Leave empty to create an empty survey.",
            "source": {
              "url": "/component/appmixer/surveymonkey/core/ListSurveys?outPort=out",
              "data": {
                "properties": {
                  "isSource": true
                },
                "transform": "./ListSurveys#toSelectArray"
              }
            }
          },
          "fromTemplateId": {
            "type": "text",
            "index": 6,
            "label": "Copy From Template ID",
            "tooltip": "Create the survey from this SurveyMonkey template (see GET /v3/survey_templates). Use either Copy From Survey or Copy From Template ID."
          }
        }
      }
    }
  ],
  "outPorts": [
    {
      "name": "out",
      "schema": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "title": "Survey ID",
            "example": "405123456"
          },
          "title": {
            "type": "string",
            "title": "Title",
            "example": "Customer Satisfaction 2026"
          },
          "nickname": {
            "type": "string",
            "title": "Nickname",
            "example": "CSAT Q1"
          },
          "language": {
            "type": "string",
            "title": "Language",
            "example": "en"
          },
          "category": {
            "type": "string",
            "title": "Category",
            "example": "customer_feedback"
          },
          "question_count": {
            "type": "integer",
            "title": "Question Count",
            "example": 10
          },
          "page_count": {
            "type": "integer",
            "title": "Page Count",
            "example": 2
          },
          "response_count": {
            "type": "integer",
            "title": "Response Count",
            "example": 12
          },
          "date_created": {
            "type": "string",
            "title": "Date Created",
            "example": "2026-03-05T14:30:00"
          },
          "date_modified": {
            "type": "string",
            "title": "Date Modified",
            "example": "2026-03-06T09:12:00"
          },
          "folder_id": {
            "type": "string",
            "title": "Folder ID",
            "example": "1234"
          },
          "footer": {
            "type": "boolean",
            "title": "Footer",
            "example": true
          },
          "custom_variables": {
            "type": "object",
            "title": "Custom Variables",
            "example": {
              "name": "label"
            },
            "properties": {}
          },
          "buttons_text": {
            "type": "object",
            "title": "Buttons Text",
            "properties": {
              "done_button": {
                "type": "string",
                "title": "Buttons Text.Done Button",
                "example": "Done"
              },
              "prev_button": {
                "type": "string",
                "title": "Buttons Text.Previous Button",
                "example": "Prev"
              },
              "exit_button": {
                "type": "string",
                "title": "Buttons Text.Exit Button",
                "example": "Exit"
              },
              "next_button": {
                "type": "string",
                "title": "Buttons Text.Next Button",
                "example": "Next"
              }
            }
          },
          "preview": {
            "type": "string",
            "title": "Preview URL",
            "example": "https://www.surveymonkey.com/r/Preview/?sm=abc123"
          },
          "edit_url": {
            "type": "string",
            "title": "Edit URL",
            "example": "https://www.surveymonkey.com/create/?sm=abc123"
          },
          "collect_url": {
            "type": "string",
            "title": "Collect URL",
            "example": "https://www.surveymonkey.com/collect/list?sm=abc123"
          },
          "analyze_url": {
            "type": "string",
            "title": "Analyze URL",
            "example": "https://www.surveymonkey.com/analyze/abc123"
          },
          "summary_url": {
            "type": "string",
            "title": "Summary URL",
            "example": "https://www.surveymonkey.com/summary/abc123"
          },
          "href": {
            "type": "string",
            "title": "API URL",
            "example": "https://api.surveymonkey.com/v3/surveys/405123456"
          }
        }
      }
    }
  ],
  "icon": "(data URI omitted)"
}
```
