ContextQMD
Back to Airbyte

SurveyMonkey

docs/integrations/sources/surveymonkey.md

2.0.012.7 KB
Original Source

SurveyMonkey

Set up a SurveyMonkey source connector to extract survey, question, response, and collector data from your SurveyMonkey account.

:::note

Airbyte officially supports OAuth for SurveyMonkey only for the US. If you have any issues, contact us.

:::

Prerequisites

Before you begin, have the following ready.

<!-- env:oss -->

For Airbyte Open Source

  • A registered SurveyMonkey app
  • A SurveyMonkey access token, found on the Settings page of your SurveyMonkey app
  • If your SurveyMonkey app is a Public app, you also need a Client ID and Client Secret, found on the Settings page of your SurveyMonkey app
<!-- /env:oss --> <!-- env:cloud -->

For Airbyte Cloud

<!-- /env:cloud -->

You may want to review SurveyMonkey's API docs, but this isn't strictly necessary.

Create the SurveyMonkey source

<!-- env:cloud -->

Airbyte Cloud steps

  1. In the left navigation bar, click Sources.
  2. Click New source.
  3. Find and click SurveyMonkey.
  4. Click Authenticate your SurveyMonkey account. Log in and authorize Airbyte to access your SurveyMonkey account.
  5. Fill out the form.
    • Source name: A short, descriptive name to help you identify this source in Airbyte.
    • Start Date: Any data before this date will not be extracted.
    • Origin datacenter of the SurveyMonkey account: Airbyte needs to know this because API access URLs may depend on the origin datacenter's location.
    • Survey Monkey survey IDs: If you want to extract specific surveys, enter the IDs of those surveys. If you want to extract all survey data, leave this blank.
  6. Click Set up source. Wait a moment while Airbyte tests the connection.
<!-- /env:cloud --> <!-- env:oss -->

Airbyte Open Source steps

  1. In the left navigation bar, click Sources.
  2. Click New source.
  3. Find and click SurveyMonkey.
  4. Fill out the form.
    • Source name: A short, descriptive name to help you identify this source in Airbyte.
    • Access Token: Your SurveyMonkey app's access token.
    • Client ID: Your SurveyMonkey app's client id.
    • Client Secret: Your SurveyMonkey app's client secret.
    • Start Date: Any data before this date will not be extracted.
    • Origin datacenter of the SurveyMonkey account: Airbyte needs to know this because API access URLs may depend on the origin datacenter's location.
    • Survey Monkey survey IDs: If you want to extract specific surveys, enter the IDs of those surveys. If you want to extract all survey data, leave this blank.
  5. Click Set up source. Wait a moment while Airbyte tests the connection.
<!-- /env:oss -->

Supported streams and sync modes

You can stream the following data from SurveyMonkey using the sync modes indicated.

StreamSync mode
SurveysFull refresh, incremental
SurveyPagesFull refresh
SurveyQuestionsFull refresh
SurveyResponsesFull refresh, incremental
SurveyCollectorsFull refresh
CollectorsFull refresh

Rate limits

SurveyMonkey's API has default rate limits for draft and private apps. Airbyte uses caching to economize its usage of the API. However, if you need a higher quota, SurveyMonkey offers temporary and permanent options to increase your rate limits.

Changelog

<details> <summary>Expand to review</summary>
VersionDatePull RequestSubject
0.3.482026-02-2473720fix(source-surveymonkey): use lowercase sort_order parameter to match SurveyMonkey API validation
0.3.472025-10-2168542Update dependencies
0.3.462025-10-1467916Update dependencies
0.3.452025-10-0767476Update dependencies
0.3.442025-09-3066894Update dependencies
0.3.432025-09-2366372Update dependencies
0.3.422025-09-0965682Update dependencies
0.3.412025-08-2465476Update dependencies
0.3.402025-08-1665023Update dependencies
0.3.392025-08-1064849Update dependencies
0.3.382025-08-0254085Update dependencies
0.3.372025-07-1663345Update CDK version to fix tests and allow for bumping version for metadata updates.
0.3.362025-02-0153050Update dependencies
0.3.352025-01-2551993Update dependencies
0.3.342025-01-1151412Update dependencies
0.3.332025-01-0450936Update dependencies
0.3.322024-12-2850760Update dependencies
0.3.312024-12-2149774Update dependencies
0.3.302024-12-1249399Starting with this version, the Docker image is now rootless. Please note that this and future versions will not be compatible with Airbyte versions earlier than 0.64
0.3.292024-11-0448168Update dependencies
0.3.282024-10-2947754Update dependencies
0.3.272024-10-2847073Update dependencies
0.3.262024-10-1246801Update dependencies
0.3.252024-10-0546448Update dependencies
0.3.242024-09-2846129Update dependencies
0.3.232024-09-2145770Update dependencies
0.3.222024-09-1445519Update dependencies
0.3.212024-09-0745316Update dependencies
0.3.202024-08-3145002Update dependencies
0.3.192024-08-2444629Update dependencies
0.3.182024-08-1744343Update dependencies
0.3.172024-08-1243759Update dependencies
0.3.162024-08-1043698Update dependencies
0.3.152024-08-0343107Update dependencies
0.3.142024-07-2742752Update dependencies
0.3.132024-07-2042308Update dependencies
0.3.122024-07-1341701Update dependencies
0.3.112024-07-1041352Update dependencies
0.3.102024-07-0941258Update dependencies
0.3.92024-07-0640958Update dependencies
0.3.82024-06-2640549Migrate off deprecated auth package
0.3.72024-06-2540298Update dependencies
0.3.62024-06-2240031Update dependencies
0.3.52024-06-0739329Add CheckpointMixin for state management
0.3.42024-06-0639244[autopull] Upgrade base image to v1.2.2
0.3.32024-05-2238559Migrate Python stream authenticator to requests_native_auth package
0.3.22024-05-2038244Replace AirbyteLogger with logging.Logger and upgrade base image
0.3.12024-04-2436664Schema descriptions and CDK 0.80.0
0.3.02024-02-2235561Migrate connector to low-code
0.2.42024-02-1235168Manage dependencies with Poetry
0.2.32023-10-1931599Base image migration: remove Dockerfile and use the python-connector-base image
0.2.22023-05-1226024Fix dependencies conflict
0.2.12023-04-2725109Fix add missing params to stream SurveyResponses
0.2.02023-04-1823721Add SurveyCollectors and Collectors stream
0.1.162023-04-1325080Fix spec.json required fields and update schema for surveys and survey_responses
0.1.152023-02-1122865Specified date formatting in specification
0.1.142023-01-2722024Set AvailabilityStrategy for streams explicitly to None
0.1.132022-11-2919868Fix OAuth flow urls
0.1.122022-10-1317964Add OAuth for Eu and Ca
0.1.112022-09-2817326Migrate to per-stream states
0.1.102022-09-1416706Fix 404 error when handling nonexistent surveys
0.1.92022-07-2814998Fix state for response stream, fixed backoff behaviour, added unittest
0.1.82022-05-2013046Fix incremental streams
0.1.72022-02-248768Add custom survey IDs to limit API calls
0.1.62022-01-149508Scopes change
0.1.52021-12-288628Update fields in source-connectors specifications
0.1.42021-11-117868Improve 'check' using '/users/me' API call
0.1.32021-11-017433Remove unsused oAuth flow parameters
0.1.22021-10-277433Add OAuth support
0.1.12021-09-105983Fix caching for gzip compressed http response
0.1.02021-07-064097Initial Release
</details>