SurveyMonkey V3

_data/taps/schemas/surveymonkey/v3/surveymonkey-v3-foreign-keys.yml

@@ -0,0 +1,55 @@
+tap: surveymonkey
+version: '3'
+keys:
+  responses_id:
+  - table: responses
+    keys:
+    - id
+  - table: simplified_responses
+    keys:
+    - id
+  survey_details_id:
+  - table: survey_details
+    keys:
+    - id
+  - table: responses
+    keys:
+    - survey_id
+  - table: simplified_responses
+    keys:
+    - survey_id
+tables:
+- table-name: responses
+  join:
+  - table-name: simplified_responses
+    keys:
+    - key: id
+      foreign-key: id
+    - key: survey_id
+      foreign-key: survey_id
+  - table-name: survey_details
+    keys:
+    - key: survey_id
+      foreign-key: id
+- table-name: simplified_responses
+  join:
+  - table-name: responses
+    keys:
+    - key: id
+      foreign-key: id
+    - key: survey_id
+      foreign-key: survey_id
+  - table-name: survey_details
+    keys:
+    - key: survey_id
+      foreign-key: id
+- table-name: survey_details
+  join:
+  - table-name: responses
+    keys:
+    - key: id
+      foreign-key: survey_id
+  - table-name: simplified_responses
+    keys:
+    - key: id
+      foreign-key: survey_id

_data/taps/schemas/surveymonkey/v3/surveymonkey-v3-tables.yml

@@ -0,0 +1,43 @@
+tap: surveymonkey
+version: '3'
+tables:
+- name: responses
+  description: This table contains information about your survey responses.
+  links:
+    doc-link: https://developer.surveymonkey.com/api/v3/
+    singer-schema: https://github.com/singer-io/tap-surveymonkey/blob/master/tap_surveymonkey/schemas/responses.json
+    api-method: https://developer.surveymonkey.com/api/v3/#collectors-id-responses-id-details
+  table-details:
+    replication-method: Key-based Incremental
+    primary-key: id
+    replication-key: date_modified
+- name: simplified_responses
+  description: This table contains a simplified version of information about your
+    survey responses.
+  links:
+    doc-link: https://developer.surveymonkey.com/api/v3/
+    singer-schema: https://github.com/singer-io/tap-surveymonkey/blob/master/tap_surveymonkey/schemas/simplified_responses.json
+    api-method: https://developer.surveymonkey.com/api/v3/#collectors-id-responses-id-details
+  table-details:
+    replication-method: Key-based Incremental
+    primary-key: id
+    replication-key: date_modified
+- name: surveys
+  description: This table contains information about your surveys.
+  links:
+    doc-link: https://developer.surveymonkey.com/api/v3/
+    singer-schema: https://github.com/singer-io/tap-surveymonkey/tree/TDL-23990-changes/tap_surveymonkey/schemas/surveys.json
+  table-details:
+    replication-method: Key-based Incremental
+    primary-key: id
+    replication-key: date_modified
+- name: survey_details
+  description: This table contains information about your survey details.
+  links:
+    doc-link: https://developer.surveymonkey.com/api/v3/
+    singer-schema: https://github.com/singer-io/tap-surveymonkey/blob/master/tap_surveymonkey/schemas/survey_details.json
+    api-method: https://developer.surveymonkey.com/api/v3/#surveys
+  table-details:
+    replication-method: Key-based Incremental
+    primary-key: id
+    replication-key: date_modified

_data/taps/versions/surveymonkey.yml

@@ -11,9 +11,13 @@
 #   SURVEYMONKEY VERSIONS   #
 # ------------------------- #
 
-latest-version: "2"
+latest-version: "3"
 
 released-versions:
+  - number: "3" ## beta, released, deprecated
+    date-released: "May 30, 2026"
+    # date-last-connection:
+
   - number: "2" ## beta, released, deprecated
     date-released: "October 3, 2023" # Full release: September 2, 2020
     # date-last-connection:

_saas-integrations/surveymonkey/v2/surveymonkey-v2.md

@@ -13,10 +13,10 @@
 # -------------------------- #
 
 title: SurveyMonkey (v2)
-permalink: /integrations/saas/surveymonkey
+permalink: /integrations/saas/surveymonkey/v2
 keywords: surveymonkey, integration, schema, etl surveymonkey, surveymonkey etl, surveymonkey schema
 layout: singer
-# input: false
+input: false
 
 key: "surveymonkey-setup"
 

_saas-integrations/surveymonkey/v3/surveymonkey-v3.md

@@ -0,0 +1,147 @@
+---
+# -------------------------- #
+#     USING THIS TEMPLATE    #
+# -------------------------- #
+
+## NEED HELP USING THIS TEMPLATE? SEE:
+## https://docs-about-stitch-docs.netlify.com/reference/integration-templates/saas/
+## FOR INSTRUCTIONS & REFERENCE INFO
+
+
+# -------------------------- #
+#      Page & Formatting     #
+# -------------------------- #
+
+title: SurveyMonkey (v3)
+permalink: /integrations/saas/surveymonkey
+keywords: surveymonkey, integration, schema, etl surveymonkey, surveymonkey etl, surveymonkey schema
+layout: singer
+# input: false
+
+key: "surveymonkey-setup"
+
+
+# -------------------------- #
+#         Tap Details        #
+# -------------------------- #
+
+name: "surveymonkey"
+display_name: "SurveyMonkey"
+
+singer: true
+status-url: "https://developer.surveymonkey.com/tools/api_status/"
+
+tap-name: "SurveyMonkey"
+repo-url: https://github.com/singer-io/tap-surveymonkey
+
+this-version: "3"
+
+api: |
+  [{{ integration.display_name }} REST API v3](https://developer.surveymonkey.com/api/v3/){:target="new"}
+
+
+# -------------------------- #
+#       Stitch Details       #
+# -------------------------- #
+
+certified: false
+
+api-type: "platform.surveymonkey"
+
+historical: "1 year"
+frequency: "1 hour"
+tier: "Standard"
+
+anchor-scheduling: true
+cron-scheduling: true
+
+extraction-logs: true
+loading-reports: true
+
+table-selection: true
+column-selection: true
+
+# attribution-window: "# days"
+# attribution-is-configurable: 
+
+# setup-name: ""
+
+
+# -------------------------- #
+#      Feature Summary       #
+# -------------------------- #
+
+feature-summary: |
+  Stitch's {{ integration.display_name }} integration replicates data using the {{ integration.api | flatify | strip }}. Refer to the [Schema](#schema) section for a list of objects available for replication.
+
+
+# -------------------------- #
+#      Incompatibilities     #
+# -------------------------- #
+
+## uncomment section below if integration is compatible with any Stitch destinations
+## if incompatible with multiple destinations, create a section for each destination
+
+## incompatible:
+  ## [redshift]: "always,sometimes,never"
+  ## reason: "copy" 
+
+# -------------------------- #
+#      Setup Instructions    #
+# -------------------------- #
+
+requirements-list:
+  - item: |
+      **An Enterprise {{ integration.display_name }} account.** This is required to complete the setup in {{ integration.display_name }}.
+
+setup-steps:
+  - title: "Retrieve your access token and Survey ID"
+    anchor: "retrieve-access-token-and-survey-id"
+    content: |
+      {% capture paid-account-content %}
+      **Note**: An Enterprise {{ integration.display_name }} account is required to complete this step. 
+      {% endcapture %}
+
+      {% include note.html type="single-line" content=paid-account-content %}
+
+      1. Login to your {{ integration.display_name }} and go to [App Directory](https://www.surveymonkey.com/apps){:target="new"}.
+      2. Type `stitchdata` in the search input box to find the Stitchdata ETL app. 
+      3. Click the **Visit Site** button on the right side of the page. 
+      4. Click the **Authorize** button.
+      5. The access token and list of surveys are shown after authorization:
+
+         ![Access token and the list of Survey IDs.]({{ site.baseurl }}/images/integrations/surveymonkey-access-token.png){:style="max-width: 450px;"}
+
+      Leave this page open - you'll need it in the next step. **Note**: You may come back at any time to retrieve your access token or identify a new survey ID.
+
+  - title: "Add {{ integration.display_name }} as a Stitch data source"
+    anchor: "add-stitch-data-source"
+    content: |
+      {% include integrations/shared-setup/connection-setup.html %}
+      4. In the **Access Token** field, add your access token that you obtained in [Step 1](#retrieve-access-token-and-survey-id).
+      5. In the **Survey Id** field, add your survey ID that you retrieved in [Step 1](#retrieve-access-token-and-survey-id).
+  - title: "Define the historical replication start date"
+    anchor: "define-historical-sync"
+    content: |
+      {% include integrations/saas/setup/historical-sync.html %}
+
+  - title: "Create a replication schedule"
+    anchor: "define-rep-frequency"
+    content: |
+      {% include integrations/shared-setup/replication-frequency.html %}
+
+  - title: "Set objects to replicate"
+    anchor: "setting-data-to-replicate"
+    content: |
+      {% include integrations/shared-setup/data-selection/object-selection.html %}
+
+
+# -------------------------- #
+#     Integration Tables     #
+# -------------------------- #
+
+# Looking for the table schemas & info?
+# Each table has a its own .md file in /_integration-schemas/surveymonkey/v1
+---
+{% assign integration = page %}
+{% include misc/data-files.html %}