> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pinkfish.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# surveymonkey-collectors

> SurveyMonkey Collectors - Manage collectors, messages, recipients, and distribution

**Server path:** `/surveymonkey-collectors` | **Type:** Application | **PCID required:** Yes

## Tools

| Tool                                                                                                      | Description               |
| --------------------------------------------------------------------------------------------------------- | ------------------------- |
| [`surveymonkey_collectors_add_bulk_recipients`](#surveymonkey_collectors_add_bulk_recipients)             | Add bulk recipients       |
| [`surveymonkey_collectors_create_collector`](#surveymonkey_collectors_create_collector)                   | Create collector          |
| [`surveymonkey_collectors_create_collector_message`](#surveymonkey_collectors_create_collector_message)   | Create collector message  |
| [`surveymonkey_collectors_delete_collector`](#surveymonkey_collectors_delete_collector)                   | Delete collector          |
| [`surveymonkey_collectors_delete_collector_message`](#surveymonkey_collectors_delete_collector_message)   | Delete collector message  |
| [`surveymonkey_collectors_get_collector`](#surveymonkey_collectors_get_collector)                         | Get collector             |
| [`surveymonkey_collectors_get_collector_message`](#surveymonkey_collectors_get_collector_message)         | Get collector message     |
| [`surveymonkey_collectors_get_collector_stats`](#surveymonkey_collectors_get_collector_stats)             | Get collector stats       |
| [`surveymonkey_collectors_list_collector_messages`](#surveymonkey_collectors_list_collector_messages)     | List collector messages   |
| [`surveymonkey_collectors_list_collector_recipients`](#surveymonkey_collectors_list_collector_recipients) | List collector recipients |
| [`surveymonkey_collectors_list_collectors`](#surveymonkey_collectors_list_collectors)                     | List collectors           |
| [`surveymonkey_collectors_list_message_recipients`](#surveymonkey_collectors_list_message_recipients)     | List message recipients   |
| [`surveymonkey_collectors_send_collector_message`](#surveymonkey_collectors_send_collector_message)       | Send collector message    |
| [`surveymonkey_collectors_update_collector`](#surveymonkey_collectors_update_collector)                   | Update collector          |
| [`surveymonkey_collectors_update_collector_message`](#surveymonkey_collectors_update_collector_message)   | Update collector message  |

***

## surveymonkey\_collectors\_add\_bulk\_recipients

Add bulk recipients

**Parameters:**

| Parameter          | Type      | Required | Default | Description                           |
| ------------------ | --------- | -------- | ------- | ------------------------------------- |
| `collector_id`     | string    | Yes      | —       | Collector ID                          |
| `message_id`       | string    | Yes      | —       | Message ID                            |
| `contact_list_ids` | string\[] | No       | —       | Contact list IDs to add as recipients |
| `contacts`         | object\[] | Yes      | —       | Array of contact objects              |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "collector_id": {
        "type": "string",
        "description": "Collector ID"
      },
      "message_id": {
        "type": "string",
        "description": "Message ID"
      },
      "contact_list_ids": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "description": "Contact list IDs to add as recipients"
      },
      "contacts": {
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "email": {
              "type": "string",
              "description": "The email value"
            },
            "first_name": {
              "type": "string",
              "description": "First Name"
            },
            "last_name": {
              "type": "string",
              "description": "Last Name"
            },
            "custom_fields": {
              "type": "object",
              "description": "Custom Fields"
            }
          }
        },
        "description": "Array of contact objects"
      }
    },
    "required": [
      "PCID",
      "collector_id",
      "message_id",
      "contacts"
    ]
  }
  ```
</Expandable>

***

## surveymonkey\_collectors\_create\_collector

Create collector

**Parameters:**

| Parameter                  | Type    | Required | Default | Description                              |
| -------------------------- | ------- | -------- | ------- | ---------------------------------------- |
| `survey_id`                | string  | Yes      | —       | Survey ID                                |
| `allow_multiple_responses` | boolean | No       | —       | Allow multiple responses per recipient   |
| `anonymous_type`           | string  | No       | —       | Anonymity level                          |
| `close_date`               | string  | No       | —       | Collector close date (ISO 8601)          |
| `closed_page_message`      | string  | No       | —       | Message shown when collector is closed   |
| `disqualification_message` | string  | No       | —       | Disqualification message                 |
| `name`                     | string  | No       | —       | Collector name                           |
| `password`                 | string  | No       | —       | Password for accessing the survey        |
| `password_enabled`         | boolean | No       | —       | Whether password protection is enabled   |
| `redirect_url`             | string  | No       | —       | URL to redirect to after completion      |
| `sender_email`             | string  | No       | —       | Sender email for email collectors        |
| `thank_you_message`        | string  | No       | —       | Thank you message shown after completion |
| `thank_you_page`           | object  | No       | —       | Thank you page configuration             |
| `type`                     | string  | Yes      | —       | Collector type                           |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "survey_id": {
        "type": "string",
        "description": "Survey ID"
      },
      "allow_multiple_responses": {
        "type": "boolean",
        "description": "Allow multiple responses per recipient"
      },
      "anonymous_type": {
        "type": "string",
        "description": "Anonymity level",
        "enum": [
          "not_anonymous",
          "partially_anonymous",
          "fully_anonymous"
        ]
      },
      "close_date": {
        "type": "string",
        "description": "Collector close date (ISO 8601)"
      },
      "closed_page_message": {
        "type": "string",
        "description": "Message shown when collector is closed"
      },
      "disqualification_message": {
        "type": "string",
        "description": "Disqualification message"
      },
      "name": {
        "type": "string",
        "description": "Collector name"
      },
      "password": {
        "type": "string",
        "description": "Password for accessing the survey"
      },
      "password_enabled": {
        "type": "boolean",
        "description": "Whether password protection is enabled"
      },
      "redirect_url": {
        "type": "string",
        "description": "URL to redirect to after completion"
      },
      "sender_email": {
        "type": "string",
        "description": "Sender email for email collectors"
      },
      "thank_you_message": {
        "type": "string",
        "description": "Thank you message shown after completion"
      },
      "thank_you_page": {
        "type": "object",
        "description": "Thank you page configuration"
      },
      "type": {
        "type": "string",
        "description": "Collector type",
        "enum": [
          "weblink",
          "email"
        ]
      }
    },
    "required": [
      "PCID",
      "survey_id",
      "type"
    ]
  }
  ```
</Expandable>

***

## surveymonkey\_collectors\_create\_collector\_message

Create collector message

**Parameters:**

| Parameter             | Type    | Required | Default | Description                 |
| --------------------- | ------- | -------- | ------- | --------------------------- |
| `collector_id`        | string  | Yes      | —       | Collector ID                |
| `body_html`           | string  | No       | —       | Email body in HTML          |
| `body_text`           | string  | No       | —       | Email body in plain text    |
| `is_branding_enabled` | boolean | No       | —       | Whether branding is shown   |
| `recipient_status`    | string  | No       | —       | Filter recipients by status |
| `subject`             | string  | No       | —       | Email subject               |
| `type`                | string  | Yes      | —       | Message type                |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "collector_id": {
        "type": "string",
        "description": "Collector ID"
      },
      "body_html": {
        "type": "string",
        "description": "Email body in HTML"
      },
      "body_text": {
        "type": "string",
        "description": "Email body in plain text"
      },
      "is_branding_enabled": {
        "type": "boolean",
        "description": "Whether branding is shown"
      },
      "recipient_status": {
        "type": "string",
        "description": "Filter recipients by status"
      },
      "subject": {
        "type": "string",
        "description": "Email subject"
      },
      "type": {
        "type": "string",
        "description": "Message type",
        "enum": [
          "invite",
          "reminder",
          "thank_you"
        ]
      }
    },
    "required": [
      "PCID",
      "collector_id",
      "type"
    ]
  }
  ```
</Expandable>

***

## surveymonkey\_collectors\_delete\_collector

Delete collector

**Parameters:**

| Parameter      | Type   | Required | Default | Description  |
| -------------- | ------ | -------- | ------- | ------------ |
| `collector_id` | string | Yes      | —       | Collector ID |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "collector_id": {
        "type": "string",
        "description": "Collector ID"
      }
    },
    "required": [
      "PCID",
      "collector_id"
    ]
  }
  ```
</Expandable>

***

## surveymonkey\_collectors\_delete\_collector\_message

Delete collector message

**Parameters:**

| Parameter      | Type   | Required | Default | Description  |
| -------------- | ------ | -------- | ------- | ------------ |
| `collector_id` | string | Yes      | —       | Collector ID |
| `message_id`   | string | Yes      | —       | Message ID   |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "collector_id": {
        "type": "string",
        "description": "Collector ID"
      },
      "message_id": {
        "type": "string",
        "description": "Message ID"
      }
    },
    "required": [
      "PCID",
      "collector_id",
      "message_id"
    ]
  }
  ```
</Expandable>

***

## surveymonkey\_collectors\_get\_collector

Get collector

**Parameters:**

| Parameter      | Type   | Required | Default | Description  |
| -------------- | ------ | -------- | ------- | ------------ |
| `collector_id` | string | Yes      | —       | Collector ID |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "collector_id": {
        "type": "string",
        "description": "Collector ID"
      }
    },
    "required": [
      "PCID",
      "collector_id"
    ]
  }
  ```
</Expandable>

***

## surveymonkey\_collectors\_get\_collector\_message

Get collector message

**Parameters:**

| Parameter      | Type   | Required | Default | Description  |
| -------------- | ------ | -------- | ------- | ------------ |
| `collector_id` | string | Yes      | —       | Collector ID |
| `message_id`   | string | Yes      | —       | Message ID   |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "collector_id": {
        "type": "string",
        "description": "Collector ID"
      },
      "message_id": {
        "type": "string",
        "description": "Message ID"
      }
    },
    "required": [
      "PCID",
      "collector_id",
      "message_id"
    ]
  }
  ```
</Expandable>

***

## surveymonkey\_collectors\_get\_collector\_stats

Get collector stats

**Parameters:**

| Parameter      | Type   | Required | Default | Description  |
| -------------- | ------ | -------- | ------- | ------------ |
| `collector_id` | string | Yes      | —       | Collector ID |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "collector_id": {
        "type": "string",
        "description": "Collector ID"
      }
    },
    "required": [
      "PCID",
      "collector_id"
    ]
  }
  ```
</Expandable>

***

## surveymonkey\_collectors\_list\_collector\_messages

List collector messages

**Parameters:**

| Parameter      | Type    | Required | Default | Description                |
| -------------- | ------- | -------- | ------- | -------------------------- |
| `collector_id` | string  | Yes      | —       | Collector ID               |
| `per_page`     | integer | No       | —       | Number of results per page |
| `page`         | integer | No       | —       | Page number                |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "collector_id": {
        "type": "string",
        "description": "Collector ID"
      },
      "per_page": {
        "type": "integer",
        "description": "Number of results per page"
      },
      "page": {
        "type": "integer",
        "description": "Page number"
      }
    },
    "required": [
      "PCID",
      "collector_id"
    ]
  }
  ```
</Expandable>

***

## surveymonkey\_collectors\_list\_collector\_recipients

List collector recipients

**Parameters:**

| Parameter      | Type    | Required | Default | Description                |
| -------------- | ------- | -------- | ------- | -------------------------- |
| `collector_id` | string  | Yes      | —       | Collector ID               |
| `per_page`     | integer | No       | —       | Number of results per page |
| `page`         | integer | No       | —       | Page number                |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "collector_id": {
        "type": "string",
        "description": "Collector ID"
      },
      "per_page": {
        "type": "integer",
        "description": "Number of results per page"
      },
      "page": {
        "type": "integer",
        "description": "Page number"
      }
    },
    "required": [
      "PCID",
      "collector_id"
    ]
  }
  ```
</Expandable>

***

## surveymonkey\_collectors\_list\_collectors

List collectors

**Parameters:**

| Parameter    | Type    | Required | Default | Description                                          |
| ------------ | ------- | -------- | ------- | ---------------------------------------------------- |
| `survey_id`  | string  | Yes      | —       | Survey ID                                            |
| `per_page`   | integer | No       | —       | Number of results per page                           |
| `page`       | integer | No       | —       | Page number                                          |
| `sort_by`    | string  | No       | —       | Field to sort by                                     |
| `sort_order` | string  | No       | —       | Sort order                                           |
| `include`    | string  | No       | —       | Comma-separated list of additional fields to include |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "survey_id": {
        "type": "string",
        "description": "Survey ID"
      },
      "per_page": {
        "type": "integer",
        "description": "Number of results per page"
      },
      "page": {
        "type": "integer",
        "description": "Page number"
      },
      "sort_by": {
        "type": "string",
        "description": "Field to sort by",
        "enum": [
          "name",
          "date_modified",
          "type",
          "status",
          "response_count"
        ]
      },
      "sort_order": {
        "type": "string",
        "description": "Sort order",
        "enum": [
          "ASC",
          "DESC"
        ]
      },
      "include": {
        "type": "string",
        "description": "Comma-separated list of additional fields to include"
      }
    },
    "required": [
      "PCID",
      "survey_id"
    ]
  }
  ```
</Expandable>

***

## surveymonkey\_collectors\_list\_message\_recipients

List message recipients

**Parameters:**

| Parameter      | Type    | Required | Default | Description                |
| -------------- | ------- | -------- | ------- | -------------------------- |
| `collector_id` | string  | Yes      | —       | Collector ID               |
| `message_id`   | string  | Yes      | —       | Message ID                 |
| `per_page`     | integer | No       | —       | Number of results per page |
| `page`         | integer | No       | —       | Page number                |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "collector_id": {
        "type": "string",
        "description": "Collector ID"
      },
      "message_id": {
        "type": "string",
        "description": "Message ID"
      },
      "per_page": {
        "type": "integer",
        "description": "Number of results per page"
      },
      "page": {
        "type": "integer",
        "description": "Page number"
      }
    },
    "required": [
      "PCID",
      "collector_id",
      "message_id"
    ]
  }
  ```
</Expandable>

***

## surveymonkey\_collectors\_send\_collector\_message

Send collector message

**Parameters:**

| Parameter        | Type   | Required | Default | Description                                                   |
| ---------------- | ------ | -------- | ------- | ------------------------------------------------------------- |
| `collector_id`   | string | Yes      | —       | Collector ID                                                  |
| `message_id`     | string | Yes      | —       | Message ID                                                    |
| `scheduled_date` | string | No       | —       | ISO 8601 date to schedule the send (omit to send immediately) |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "collector_id": {
        "type": "string",
        "description": "Collector ID"
      },
      "message_id": {
        "type": "string",
        "description": "Message ID"
      },
      "scheduled_date": {
        "type": "string",
        "description": "ISO 8601 date to schedule the send (omit to send immediately)"
      }
    },
    "required": [
      "PCID",
      "collector_id",
      "message_id"
    ]
  }
  ```
</Expandable>

***

## surveymonkey\_collectors\_update\_collector

Update collector

**Parameters:**

| Parameter                  | Type    | Required | Default | Description              |
| -------------------------- | ------- | -------- | ------- | ------------------------ |
| `collector_id`             | string  | Yes      | —       | Collector ID             |
| `allow_multiple_responses` | boolean | No       | —       | Allow Multiple Responses |
| `anonymous_type`           | string  | No       | —       | Anonymous Type           |
| `close_date`               | string  | No       | —       | Close Date               |
| `closed_page_message`      | string  | No       | —       | Closed Page Message      |
| `name`                     | string  | No       | —       | Collector name           |
| `password`                 | string  | No       | —       | The password value       |
| `password_enabled`         | boolean | No       | —       | Password Enabled         |
| `redirect_url`             | string  | No       | —       | Redirect Url             |
| `status`                   | string  | No       | —       | Collector status         |
| `thank_you_message`        | string  | No       | —       | Thank You Message        |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "collector_id": {
        "type": "string",
        "description": "Collector ID"
      },
      "allow_multiple_responses": {
        "type": "boolean",
        "description": "Allow Multiple Responses"
      },
      "anonymous_type": {
        "type": "string",
        "description": "Anonymous Type",
        "enum": [
          "not_anonymous",
          "partially_anonymous",
          "fully_anonymous"
        ]
      },
      "close_date": {
        "type": "string",
        "description": "Close Date"
      },
      "closed_page_message": {
        "type": "string",
        "description": "Closed Page Message"
      },
      "name": {
        "type": "string",
        "description": "Collector name"
      },
      "password": {
        "type": "string",
        "description": "The password value"
      },
      "password_enabled": {
        "type": "boolean",
        "description": "Password Enabled"
      },
      "redirect_url": {
        "type": "string",
        "description": "Redirect Url"
      },
      "status": {
        "type": "string",
        "description": "Collector status",
        "enum": [
          "open",
          "closed"
        ]
      },
      "thank_you_message": {
        "type": "string",
        "description": "Thank You Message"
      }
    },
    "required": [
      "PCID",
      "collector_id"
    ]
  }
  ```
</Expandable>

***

## surveymonkey\_collectors\_update\_collector\_message

Update collector message

**Parameters:**

| Parameter      | Type   | Required | Default | Description       |
| -------------- | ------ | -------- | ------- | ----------------- |
| `collector_id` | string | Yes      | —       | Collector ID      |
| `message_id`   | string | Yes      | —       | Message ID        |
| `body_html`    | string | No       | —       | Body Html         |
| `body_text`    | string | No       | —       | Body Text         |
| `subject`      | string | No       | —       | The subject value |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "collector_id": {
        "type": "string",
        "description": "Collector ID"
      },
      "message_id": {
        "type": "string",
        "description": "Message ID"
      },
      "body_html": {
        "type": "string",
        "description": "Body Html"
      },
      "body_text": {
        "type": "string",
        "description": "Body Text"
      },
      "subject": {
        "type": "string",
        "description": "The subject value"
      }
    },
    "required": [
      "PCID",
      "collector_id",
      "message_id"
    ]
  }
  ```
</Expandable>