KosmoKrator

surveys

SurveyMonkey CLI for AI Agents

Use the SurveyMonkey CLI from KosmoKrator to call SurveyMonkey tools headlessly, return JSON, inspect schemas, and automate workflows from coding agents, scripts, and CI.

8 functions 6 read 2 write Manual OAuth token auth

SurveyMonkey CLI Setup

SurveyMonkey can be configured headlessly with `kosmokrator integrations:configure surveymonkey`.

# Install KosmoKrator first if it is not available on PATH.
curl -fsSL https://raw.githubusercontent.com/OpenCompanyApp/kosmokrator/main/install.sh | bash

# Configure and verify this integration.
kosmokrator integrations:configure surveymonkey --set access_token="$SURVEYMONKEY_ACCESS_TOKEN" --enable --read allow --write ask --json
kosmokrator integrations:doctor surveymonkey --json
kosmokrator integrations:status --json

Credentials

Authentication type: Manual OAuth token oauth2_manual_token. Configure credentials once, then use the same stored profile from scripts, coding CLIs, Lua code mode, and the MCP gateway.

KeyEnv varTypeRequiredLabel
access_token SURVEYMONKEY_ACCESS_TOKEN Secret secret yes Access Token
url SURVEYMONKEY_URL URL url no API Base URL

Call SurveyMonkey Headlessly

Use the generic call form when another coding CLI or script needs a stable universal interface.

kosmo integrations:call surveymonkey.surveymonkey_list_surveys '{
  "page": 1,
  "per_page": 1
}' --json

Use the provider shortcut form for shorter human-facing commands.

kosmo integrations:surveymonkey surveymonkey_list_surveys '{
  "page": 1,
  "per_page": 1
}' --json

Agent Discovery Commands

These commands return structured output for coding agents that need to inspect capabilities before choosing a function.

kosmo integrations:docs surveymonkey --json
kosmo integrations:docs surveymonkey.surveymonkey_list_surveys --json
kosmo integrations:schema surveymonkey.surveymonkey_list_surveys --json
kosmo integrations:search "SurveyMonkey" --json
kosmo integrations:list --json

All CLI Functions

Every function below can be called headlessly. The generic form is stable across all integrations; the provider shortcut is shorter but specific to SurveyMonkey.

surveymonkey.surveymonkey_list_surveys

Read read

List all surveys in your SurveyMonkey account. Returns survey IDs, titles, and creation dates.

Parameters
page, per_page

Generic CLI call

kosmo integrations:call surveymonkey.surveymonkey_list_surveys '{"page":1,"per_page":1}' --json

Provider shortcut

kosmo integrations:surveymonkey surveymonkey_list_surveys '{"page":1,"per_page":1}' --json

surveymonkey.surveymonkey_get_survey

Read read

Get details of a specific SurveyMonkey survey by ID, including title, language, and question count.

Parameters
survey_id

Generic CLI call

kosmo integrations:call surveymonkey.surveymonkey_get_survey '{"survey_id":"example_survey_id"}' --json

Provider shortcut

kosmo integrations:surveymonkey surveymonkey_get_survey '{"survey_id":"example_survey_id"}' --json

surveymonkey.surveymonkey_create_survey

Write write

Create a new blank survey in SurveyMonkey with a given title.

Parameters
title

Generic CLI call

kosmo integrations:call surveymonkey.surveymonkey_create_survey '{"title":"example_title"}' --json

Provider shortcut

kosmo integrations:surveymonkey surveymonkey_create_survey '{"title":"example_title"}' --json

surveymonkey.surveymonkey_list_responses

Read read

List all bulk responses for a SurveyMonkey survey. Returns response IDs, timestamps, and answer data.

Parameters
survey_id, page, per_page

Generic CLI call

kosmo integrations:call surveymonkey.surveymonkey_list_responses '{"survey_id":"example_survey_id","page":1,"per_page":1}' --json

Provider shortcut

kosmo integrations:surveymonkey surveymonkey_list_responses '{"survey_id":"example_survey_id","page":1,"per_page":1}' --json

surveymonkey.surveymonkey_get_response

Read read

Get a single response for a SurveyMonkey survey by response ID, including all answers and metadata.

Parameters
survey_id, response_id

Generic CLI call

kosmo integrations:call surveymonkey.surveymonkey_get_response '{"survey_id":"example_survey_id","response_id":"example_response_id"}' --json

Provider shortcut

kosmo integrations:surveymonkey surveymonkey_get_response '{"survey_id":"example_survey_id","response_id":"example_response_id"}' --json

surveymonkey.surveymonkey_list_collectors

Read read

List all collectors for a SurveyMonkey survey. Collectors are distribution channels (e.g., weblink, email).

Parameters
survey_id

Generic CLI call

kosmo integrations:call surveymonkey.surveymonkey_list_collectors '{"survey_id":"example_survey_id"}' --json

Provider shortcut

kosmo integrations:surveymonkey surveymonkey_list_collectors '{"survey_id":"example_survey_id"}' --json

surveymonkey.surveymonkey_create_collector

Write write

Create a collector for a SurveyMonkey survey to distribute it. Collector types include "weblink" (shareable URL) and "email" (email invitation).

Parameters
survey_id, type, name

Generic CLI call

kosmo integrations:call surveymonkey.surveymonkey_create_collector '{"survey_id":"example_survey_id","type":"example_type","name":"example_name"}' --json

Provider shortcut

kosmo integrations:surveymonkey surveymonkey_create_collector '{"survey_id":"example_survey_id","type":"example_type","name":"example_name"}' --json

surveymonkey.surveymonkey_get_current_user

Read read

Get details of the currently authenticated SurveyMonkey user, including name, email, and plan info.

Parameters
none

Generic CLI call

kosmo integrations:call surveymonkey.surveymonkey_get_current_user '{}' --json

Provider shortcut

kosmo integrations:surveymonkey surveymonkey_get_current_user '{}' --json

Function Schemas

Use these parameter tables when building CLI payloads without calling integrations:schema first.

surveymonkey.surveymonkey_list_surveys

List all surveys in your SurveyMonkey account. Returns survey IDs, titles, and creation dates.

Operation
Read read
Schema command
kosmo integrations:schema surveymonkey.surveymonkey_list_surveys --json
ParameterTypeRequiredDescription
page integer no Page number for pagination (default: 1).
per_page integer no Number of surveys per page (default: 50, max: 100).

surveymonkey.surveymonkey_get_survey

Get details of a specific SurveyMonkey survey by ID, including title, language, and question count.

Operation
Read read
Schema command
kosmo integrations:schema surveymonkey.surveymonkey_get_survey --json
ParameterTypeRequiredDescription
survey_id string yes The survey ID.

surveymonkey.surveymonkey_create_survey

Create a new blank survey in SurveyMonkey with a given title.

Operation
Write write
Schema command
kosmo integrations:schema surveymonkey.surveymonkey_create_survey --json
ParameterTypeRequiredDescription
title string yes The title for the new survey.

surveymonkey.surveymonkey_list_responses

List all bulk responses for a SurveyMonkey survey. Returns response IDs, timestamps, and answer data.

Operation
Read read
Schema command
kosmo integrations:schema surveymonkey.surveymonkey_list_responses --json
ParameterTypeRequiredDescription
survey_id string yes The survey ID.
page integer no Page number for pagination (default: 1).
per_page integer no Number of responses per page (default: 50, max: 100).

surveymonkey.surveymonkey_get_response

Get a single response for a SurveyMonkey survey by response ID, including all answers and metadata.

Operation
Read read
Schema command
kosmo integrations:schema surveymonkey.surveymonkey_get_response --json
ParameterTypeRequiredDescription
survey_id string yes The survey ID.
response_id string yes The response ID.

surveymonkey.surveymonkey_list_collectors

List all collectors for a SurveyMonkey survey. Collectors are distribution channels (e.g., weblink, email).

Operation
Read read
Schema command
kosmo integrations:schema surveymonkey.surveymonkey_list_collectors --json
ParameterTypeRequiredDescription
survey_id string yes The survey ID.

surveymonkey.surveymonkey_create_collector

Create a collector for a SurveyMonkey survey to distribute it. Collector types include "weblink" (shareable URL) and "email" (email invitation).

Operation
Write write
Schema command
kosmo integrations:schema surveymonkey.surveymonkey_create_collector --json
ParameterTypeRequiredDescription
survey_id string yes The survey ID.
type string yes Collector type: "weblink" or "email".
name string no A display name for the collector.

surveymonkey.surveymonkey_get_current_user

Get details of the currently authenticated SurveyMonkey user, including name, email, and plan info.

Operation
Read read
Schema command
kosmo integrations:schema surveymonkey.surveymonkey_get_current_user --json
ParameterTypeRequiredDescription
No parameters.

Permissions

Headless calls still follow the integration read/write permission policy. Configure read/write defaults with integrations:configure. Add --force only for trusted automation that should bypass that policy.